Prisma在VSCode中无高亮、无补全、无法跳转，根本原因是未同时满足三个硬性条件：必须安装Prisma Labs官方扩展、schema.prisma语言模式须设为Prisma、本地prisma CLI须全局可用且版本≥v5.15.0。
Prisma 在 VSCode 里没高亮、没补全、点不进模型定义，不是插件没装，而是三个硬性条件里至少缺一个：Prisma Labs 官方扩展、schema.prisma 文件语言模式设为 Prisma、本地 prisma CLI 全局可用且版本 ≥ v5.15.0。
怎么确认装的是 Prisma Labs 官方扩展
VSCode 扩展市场搜 “Prisma”，会出现多个同名扩展。只有发布者是 Prisma Labs（蓝底白字 logo）的那个才提供完整语言服务。装错的典型表现：model User 能高亮，但 @relation 变灰、generator client 块内无补全、provider = "postgresql" 后不提示其它 provider。
- 打开命令面板（
Ctrl+Shift+P或Cmd+Shift+P），输入Extensions: Show Installed Extensions - 卸载所有非
Prisma Labs发布的 Prisma 相关扩展（包括 “Prisma Client”、“Prisma Schema” 等名字相近的） - 确认扩展版本 ≥
v5.15.0（点开扩展详情页看Version字段） - 彻底退出 VSCode 再重开——不是“重载窗口”，是完全关闭再启动
为什么 schema.prisma 还是 Plain Text
VSCode 默认不把 schema.prisma 当作 Prisma 语言，即使扩展装对了，右下角仍显示 “Plain Text”。这不是 bug，是文件关联未触发。此时只有基础语法高亮，没有字段提示、模型跳转或 @id 校验。
- 打开项目中的
prisma/schema.prisma文件 - 点击右下角语言标识（如 “Plain Text”）→
Change Language Mode→ 输入prisma→ 回车选中 - 为永久生效，在项目根目录的
.vscode/settings.json中加这一行："files.associations": { "*.prisma": "prisma" } - 若
schema.prisma在子包路径下（如packages/api/prisma/schema.prisma），VSCode 不会自动匹配该配置，仍需手动点一次语言模式
prisma generate 没运行导致 TS 里找不到 prisma
prisma.user.findUnique() 提示 “Cannot find name ‘prisma’”，根本原因不是扩展问题，而是 prisma generate 没成功执行过。类型提示和补全依赖生成的客户端代码，不是纯前端语法分析。
- 先确保
schema.prisma无红色波浪线（语法正确） - 终端执行：
npx prisma generate（pnpm用户用pnpm dlx prisma generate --no-engine） - 生成后检查
node_modules/.prisma/client是否存在，以及index.d.ts是否可读 - 在任意
.ts文件中尝试：import { PrismaClient } from '@prisma/client'，看是否报错 - 若仍无提示，删掉
node_modules/.prisma和node_modules/@prisma/client，重装依赖再生成
保存时 .prisma 文件不自动格式化
Prettier 默认不支持 .prisma 文件，即使你开了 “Format on Save”，它也基本没反应。Prisma 有自己的格式规范（比如字段缩进 2 空格、关系字段换行），必须绑定官方格式器。
- 确保已安装
prismaCLI（终端执行npx prisma --version应输出类似prisma 5.12.0） - 在项目根目录的
.vscode/settings.json中添加："[prisma]": { "editor.defaultFormatter": "Prisma.prisma" } - 若使用 Prettier 全局配置，需额外排除
.prisma文件，避免冲突 - 格式化失效时，优先检查 VSCode 集成终端里
which prisma（macOS/Linux）或where prisma（Windows）是否有输出
最容易被忽略的是：Windows 中文路径（如 C:\用户\张三\myapp\prisma\schema.prisma）会导致语言服务器卡在 “Prisma: Loading…” 或直接崩溃，这不是设置问题，是 CLI 子进程在 cmd/powershell 下对 UTF-8 路径处理不稳定。临时解法是把项目移到英文路径下，或改用 WSL。
