prisma-cli

Prisma CLI 参考

Prisma ORM CLI 命令参考。本技能提供当前 Prisma ORM 版本的命令用法、选项和最佳实践指导。

边界：Compute

请勿将此技能用于 Prisma Compute 应用部署。对于 @prisma/cli app deploy、compute:deploy、create-prisma --deploy、Compute 应用、部署、日志、域名和框架部署就绪性，请使用 prisma-compute。

何时使用

在以下情况下参考此技能：

• 设置新的 Prisma 项目（prisma init）
• 生成 Prisma Client（prisma generate）
• 运行数据库迁移（prisma migrate）
• 管理数据库状态（prisma db push/pull）
• 使用本地开发数据库（prisma dev）
• 调试 Prisma 问题（prisma debug）

按优先级分类的规则类别

优先级	类别	影响	前缀
1	设置	高	init
2	生成	高	generate
3	开发	高	dev
4	数据库	高	db-
5	迁移	关键	migrate-
6	实用工具	中	studio、validate、format、debug、mcp

命令类别

类别	命令	用途
设置	init	引导新的 Prisma 项目
生成	generate	生成 Prisma Client
验证	validate、format	模式验证和格式化
开发	dev	本地 Prisma Postgres 用于开发
数据库	db pull、db push、db seed、db execute	直接数据库操作
迁移	migrate dev、migrate deploy、migrate reset、migrate status、migrate diff、migrate resolve	模式迁移
实用工具	studio、mcp、version、debug	开发和 AI 工具

快速参考

项目设置

# 初始化新项目（创建 prisma/ 文件夹和 prisma.config.ts）
prisma init

# 使用特定数据库初始化
prisma init --datasource-provider postgresql
prisma init --datasource-provider mysql
prisma init --datasource-provider sqlite

# 使用 Prisma Postgres（云端）初始化
prisma init --db

# 使用示例模型初始化
prisma init --with-model

客户端生成

# 生成 Prisma Client
prisma generate

# 开发模式下的监听模式
prisma generate --watch

# 仅生成特定生成器
prisma generate --generator client

Bun 运行时

使用 Bun 时，始终添加 --bun 标志，以便 Prisma 使用 Bun 运行时运行（否则由于 CLI shebang，它会回退到 Node.js）：

bunx --bun prisma init
bunx --bun prisma generate

本地开发数据库

# 启动本地 Prisma Postgres
prisma dev

# 使用特定名称启动
prisma dev --name myproject

# 后台启动（分离模式）
prisma dev --detach

# 列出所有本地实例
prisma dev ls

# 停止实例
prisma dev stop myproject

# 移除实例数据
prisma dev rm myproject

数据库操作

# 从现有数据库拉取模式
prisma db pull

# 将模式推送到数据库（无迁移）
prisma db push

# 种子数据库
prisma db seed

# 执行原始 SQL
prisma db execute --file ./script.sql

迁移（开发）

# 创建并应用迁移
prisma migrate dev

# 创建带名称的迁移
prisma migrate dev --name add_users_table

# 仅创建迁移而不应用
prisma migrate dev --create-only

# 重置数据库并应用所有迁移
prisma migrate reset

迁移（生产）

# 应用待处理的迁移（CI/CD）
prisma migrate deploy

# 检查迁移状态
prisma migrate status

# 比较模式并生成差异
prisma migrate diff --from-config-datasource --to-schema schema.prisma --script

实用工具命令

# 打开 Prisma Studio（数据库 GUI）
prisma studio

# 启动 Prisma 的 MCP 服务器用于 AI 工具
prisma mcp

# 显示版本信息
prisma version
prisma -v

# 调试信息
prisma debug

# 验证模式
prisma validate

# 格式化模式
prisma format

当前 Prisma CLI 设置

新的配置文件

使用 prisma.config.ts 进行 CLI 配置：

import 'dotenv/config'
import { defineConfig, env } from 'prisma/config'

export default defineConfig({
  schema: 'prisma/schema.prisma',
  migrations: {
    path: 'prisma/migrations',
    seed: 'tsx prisma/seed.ts',
  },
  datasource: {
    url: env('DATABASE_URL'),
  },
})

当前命令行为

• 在 migrate dev、db push 或其他模式同步后，如果需要新的客户端输出，请显式运行 prisma generate
• 在 migrate dev 或 migrate reset 后，如果需要种子数据，请显式运行 prisma db seed
• 使用 prisma db execute --file ... 执行原始 SQL 脚本

环境变量

在 prisma.config.ts 中显式加载环境变量，通常使用 dotenv：

// prisma.config.ts
import 'dotenv/config'

规则文件

有关详细的命令文档，请参阅各个规则文件：

references/init.md           - 项目初始化
references/generate.md       - 客户端生成
references/dev.md            - 本地开发数据库
references/db-pull.md        - 数据库内省
references/db-push.md        - 模式推送
references/db-seed.md        - 数据库种子
references/db-execute.md     - 原始 SQL 执行
references/migrate-dev.md    - 开发迁移
references/migrate-deploy.md - 生产迁移
references/migrate-reset.md  - 数据库重置
references/migrate-status.md - 迁移状态
references/migrate-resolve.md - 迁移解决
references/migrate-diff.md   - 模式差异
references/studio.md         - 数据库 GUI
references/mcp.md            - Prisma MCP 服务器
references/validate.md       - 模式验证
references/format.md         - 模式格式化
references/debug.md          - 调试信息

如何使用

使用上面的命令类别进行导航，然后打开您需要的特定命令参考文件。