Prisma Studio 与 CLI 命令速览

启动 Prisma Studio

Prisma Studio 是内置的可视化数据库编辑器，随 CLI 一起安装，不需要额外下载。在项目根目录执行：

npx prisma studio

默认在 http://localhost:5555 启动，并自动打开浏览器。常用选项：

选项	作用
--port 7777	换端口
--browser none	不自动打开浏览器
--browser firefox	指定浏览器
--url "postgresql://..."	跳过项目配置，直连任意数据库
--config ./prisma.config.ts	指定配置文件

Studio 目前支持 PostgreSQL、MySQL、SQLite。CockroachDB 和 MongoDB 暂不支持，需要 MongoDB 的请留在 v6.19。

Studio 能做什么

界面是表格风格，左边栏列出所有表，点开就能操作：

• 编辑：双击单元格改值，回车保存
• 新增：点 + 号，填必填字段后提交
• 删除：勾选行，点垃圾桶，删除前会确认
• 筛选排序：点筛选图标加条件，点列头排序
• 关系钻取：外键单元格可以点进去，看到关联的另一行；反向也能从关联计数跳回子表
• 导出：一键导出 CSV 或 JSON
• 暗色模式：v7.6 起支持，偏好设置里切换

Studio 的定位是「看数据、改数据」。改表结构不是它的活，那是迁移的职责。

进阶用法还有两种：

• VS Code 集成：装官方 Prisma 扩展，登录后在活动栏直接打开 Studio，不用离开编辑器。
• 嵌入应用：用 @prisma/studio-core 把 Studio 嵌进自己的 React 应用，可以做内部管理后台。开源版 Apache 2.0 许可，但必须保留 Prisma 品牌标识。

CLI 命令全景

prisma 命令按功能分成几族：

命令	作用
prisma init	初始化项目
prisma generate	生成 Prisma Client（支持 --watch 监听 Schema 自动重生成）
prisma migrate dev	开发环境迁移：生成并应用
prisma migrate deploy	生产环境迁移：只应用已有的
prisma migrate reset	重置数据库并重放迁移（开发用）
prisma migrate status	检查迁移是否落后
prisma migrate diff	对比两个数据源的差异
prisma migrate resolve	手动标记迁移为已应用/已回滚
prisma db pull	内省（Introspection）：从数据库反向生成 Schema
prisma db push	不建历史，直接把 Schema 推到数据库
prisma db seed	执行种子脚本
prisma db execute	执行 SQL 文件
prisma studio	打开可视化编辑器
prisma validate	校验 Schema 语法
prisma format	格式化 Schema（对齐缩进、捕获明显问题）
prisma version	显示版本信息
prisma debug	输出排障信息

入门阶段高频使用的只有五六个：init、migrate dev、generate、studio、validate。其余在对应章节展开。

db push：原型利器，生产禁区

db push 把 Schema 直接同步到数据库，不生成迁移历史。适合什么场景？原型验证、本地开发、以及不想维护迁移历史的快速实验。

npx prisma db push

两个注意点：

• 可能造成数据丢失。Prisma 会警告并要求 --accept-data-loss 确认。
• v7 里它同样不再自动执行 generate，需要手动补。

给命令加「快捷键」

常用命令可以写进 package.json 的 scripts：

{
  "scripts": {
    "db:migrate": "prisma migrate dev",
    "db:generate": "prisma generate",
    "db:studio": "prisma studio",
    "db:seed": "tsx prisma/seed.ts"
  }
}

之后 npm run db:studio 就能启动 Studio。少敲几个字符，也统一了团队习惯。

参考来源

• Prisma 官方文档：prisma studio、prisma db push（CLI reference）、CLI 命令参考（cli/index）
• Prisma 官方文档：Prisma Studio 入门（Getting started）、VS Code 集成、嵌入应用（Embedding）
• 英文教程：MapaGam 博客 - Prisma CLI 命令、Prisma Studio
• 英文教程：DevTools Cheatsheets - Prisma