Prisma CLI 命令参考技能,提供当前 Prisma ORM 版本下命令行工具的命令用法、选项与最佳实践指导。
用途 适用于设置新的 Prisma 项目(prisma init)、生成 Prisma Client(prisma generate)、运行数据库迁移(prisma migrate)、管理数据库状态(prisma db push/pull)、使用本地开发数据库(prisma dev)、调试 Prisma 问题(prisma debug)、生成 Shell 补全(prisma complete)等场景。
主要能力与命令分类
- 设置:init,初始化 Prisma 项目。
- 生成:generate,生成 Prisma Client;支持 --watch 监听模式和 --generator client 指定生成器。
- 校验:validate、format,进行 Schema 校验与格式化。
- 开发:dev,用于本地开发的 Prisma Postgres;支持 --name、--detach,以及 dev ls、dev stop、dev rm 等子命令。
- 数据库:db pull、db push、db seed、db execute,进行直接数据库操作。
- 迁移:migrate dev、migrate deploy、migrate reset、migrate status、migrate diff、migrate resolve。
- 实用工具:complete、studio、mcp、version、debug,用于 Shell、开发与 AI 工具。
使用方式 常用命令示例包括:prisma init(可带 --datasource-provider postgresql/mysql/sqlite、--db、--with-model);prisma generate;prisma dev 及其子命令;prisma db pull/push/seed/execute;开发环境使用 prisma migrate dev(可带 --name、--create-only)与 prisma migrate reset,生产环境使用 prisma migrate deploy 和 prisma migrate status;以及 prisma studio、prisma mcp、prisma version、prisma debug、prisma validate、prisma format、prisma complete zsh。 使用 Bun 运行时需始终添加 --bun 标志(如 bunx --bun prisma init),否则会因 CLI shebang 回退到 Node.js。 新版配置使用 prisma.config.ts,通过 defineConfig 定义 schema、migrations(含 seed)和 datasource(url);环境变量需在 prisma.config.ts 中显式加载,常用 dotenv。可在 migrate dev、db push 等 Schema 同步后显式运行 prisma generate 获取最新客户端输出,并在 migrate dev 或 migrate reset 后显式运行 prisma db seed 获取种子数据;原始 SQL 脚本使用 prisma db execute --file。
AI 安全约束 当检测到 AI 智能体时,Prisma 会阻止破坏性命令,直到智能体获得用户明确同意,涉及 migrate reset、db push --force-reset、db push --accept-data-loss。需在运行命令前立即说明确切的数据丢失影响并请求同意,不得从先前或无关消息推断同意;自动化如需要同意变量,应将 PRISMA_USER_CONSENT_FOR_DANGEROUS_AI_ACTION 设置为用户确切的同意消息,不得自行编造文本。Prisma MCP 服务器刻意不提供 migrate-reset 工具,执行任何破坏性 Prisma 命令前应阅读 references/agent-safety.md。
适用场景与限制 该技能面向 Prisma ORM 的命令行使用,包含各命令的详细参考文件(init、generate、dev、db-pull、db-push、db-seed、db-execute、migrate-dev、migrate-deploy、migrate-reset、migrate-status、migrate-resolve、migrate-diff、studio、mcp、complete、agent-safety、validate、format、debug)。边界说明:不要将稳定的 ORM 命令(prisma)与公测版 Platform 包(@prisma/cli、二进制 prisma-cli)混淆;Compute 应用与工作区认证应使用 prisma-compute,Platform 项目与数据库应使用 prisma-postgres。其他具体功能、收费与平台信息资料未提供。