Prisma自动补全需同时满足装对Prisma Labs扩展、文件语言模式设为Prisma、本地prisma CLI全局可用且版本匹配；缺一则仅剩语法高亮，字段不提示、@relation报红、无法跳转定义。
Prisma 的自动补全在 VSCode 里不是开个开关就能用的，它依赖三个硬性条件：装对扩展、文件语言模式正确、本地 prisma CLI 可执行。缺一不可，少一个就只能看到语法高亮，点不进模型、字段不提示、@relation 报红。
装 Prisma 扩展必须认准发布者是 Prisma Labs
搜“Prisma”时市场会出现多个同名扩展，但只有发布者为 Prisma Labs（蓝底白字 logo）的那个才提供完整语言服务。装错会导致：
-
schema.prisma文件里model User能高亮，但按 Ctrl/Cmd + 点击跳不到定义 -
generator client块内无补全，provider = "postgresql"后不提示其它 provider - 和 TypeScript 插件冲突，TS 文件里
prisma.user.findMany()提示 “Cannot find name 'prisma'”
操作建议：
- 卸载所有非 Prisma Labs 发布的 Prisma 相关扩展
- 重启 VSCode（不是重载窗口，是彻底退出再打开）
- 确认扩展版本 ≥
v5.15.0（命令面板输入Extensions: Show Installed Extensions查看）
schema.prisma 文件必须被识别为 Prisma 语言模式
VSCode 默认把 schema.prisma 当作纯文本，即使装了扩展也不会自动切换语言模式。现象是右下角状态栏显示 “Plain Text”，而非 “Prisma”。
手动设置方法：
- 打开
prisma/schema.prisma文件 - 点击右下角语言标识（如 “Plain Text”）→
Change Language Mode→ 输入prisma→ 回车选中
永久生效需加配置：
{
"files.associations": {
"*.prisma": "prisma"
}
}
注意：files.associations 是工作区级或用户级设置，写进项目根目录的 .vscode/settings.json 最稳妥；若文件在子包里（如 packages/api/prisma/schema.prisma），也得单独点一次语言模式，VSCode 不会递归匹配。
prisma CLI 必须全局可用且版本匹配
语法高亮靠扩展，而字段跳转、@id 校验、@relation 补全这些语义功能，全靠本地 prisma CLI 启动语言服务器。常见失效场景：
- 终端运行
npx prisma --version报错或无输出 - VSCode 集成终端里
which prisma返回空 - Windows 中文路径下状态栏卡在 “Prisma: Loading…”
解决路径：
- 全局安装：
npm install -g prisma（pnpm用户用pnpm add -g prisma） - 确认 Node.js 版本 ≥
v18.17.0或v20.9.0（旧版可能无法加载 v5+ CLI） - Windows 中文路径问题无完美解，临时方案是用 WSL，或把项目移到英文路径如
C:/dev/myapp - 装完后在
schema.prisma标签页执行命令面板里的Prisma: Reload Schema
补全失效时优先检查这三件事
不是所有“没提示”都要重装，先快速验证关键链路：
- 右下角状态栏是否显示
Prisma Language Server Ready？没出现就说明 CLI 没起来 - 打开
schema.prisma后，按 Ctrl/Cmd + 点击任意model名称，能否跳转到该 model 定义处？不能跳 = 语言服务器未加载 - 在 TS 文件里输入
prisma.，有没有方法列表？没有 =prisma generate没运行过，或node_modules/.prisma/client路径被files.exclude错误排除
最常被忽略的是：prisma generate 必须手动运行一次才能生成客户端类型，否则 TS 层根本不知道 prisma.user 是什么——这不是插件问题，是 Prisma 工作流本身的要求。
