必须在项目根目录的.vscode/settings.json中配置{"[prisma]": {"editor.formatonsave": true, "editor.defaultformatter": "prisma.prisma"}}，并确保语言模式为prisma、官方prisma插件已安装、prisma generate已执行且cli可用，三者缺一不可。
schema.prisma 文件保存时自动格式化
Prisma 自带格式器，但 VSCode 默认不启用它，Prettier 对 .prisma 文件完全无效。必须显式绑定官方格式器，否则缩进错乱、字段换行不一致、@relation 块对齐混乱等问题会持续出现。
- 在项目根目录的
.vscode/settings.json中添加：{"[prisma]": {"editor.formatOnSave": true, "editor.defaultFormatter": "Prisma.prisma"}} - 确保
Prisma插件已安装且为官方版本（发布者：Prisma Labs），非官方插件可能不提供格式器入口 - 若保存后仍无反应，检查右下角语言模式是否为
Prisma（不是Plain Text）；点错一次就失效
快速生成 Prisma 客户端类型
prisma generate 是触发 IntelliSense 的硬性前提——VSCode 不会从 schema 推导类型，只读取 node_modules/.prisma/client 下的生成文件。没运行过，prisma.user.findUnique 就永远没提示。
- 推荐快捷键绑定：
Ctrl+Shift+P→ 输入Prisma: Generate Client→ 回车（该命令由 Prisma 插件提供，比手动敲npx prisma generate更可靠） - 若用
pnpm，需额外加--no-engine参数；可在快捷键绑定中通过terminalCommand扩展实现，但更简单的是在终端里直接跑pnpm dlx prisma generate --no-engine - 生成失败常见原因是 schema 语法错误（比如漏写
provider或datasource），先解决红色波浪线再重试
一键启动 Prisma Studio 查看数据
Prisma Studio 不是常驻面板，不会自动弹出，必须主动触发。依赖三个条件同时满足：schema 文件语言模式为 Prisma、全局 prisma CLI 可用（which prisma 有输出）、项目根目录存在合法 schema.prisma。
- 最稳的快捷方式：
Ctrl+Shift+P→ 输入Prisma: Launch Studio→ 回车（该命令会校验前置条件，失败时明确报错） - 若 VSCode 集成终端里
prisma不在PATH，可改用npx prisma studio，它绕过全局 CLI 依赖，但需确保项目有package.json和node_modules - Studio 启动后默认打开
http://localhost:5555，改数据不会同步触发prisma generate，这是设计如此，不是 bug
切换 .prisma 文件语言模式的快捷操作
每次新建或打开 schema.prisma，右下角常显示 Plain Text，高亮、跳转、@map 校验全失效。手动点选太慢，应设为可一键触发的操作。
- 图形界面最快路径：
Ctrl+K Ctrl+M（Windows/Linux）或Cmd+K Cmd+M（Mac），然后输入prisma回车 —— 这是 VSCode 内置的“更改语言模式”快捷键，无需额外配置 - 若子包路径如
packages/api/prisma/schema.prisma未被files.associations覆盖，仍需手动切一次；"files.associations": {"*.prisma": "prisma"}只对根目录生效 - 切完仍是
Plain Text？大概率装了冲突插件（比如第三方 “Prisma Schema”），卸载所有非 Prisma Labs 发布的 Prisma 相关扩展
