Prisma高亮需同时满足三条件：安装Prisma Labs官方扩展（v5.15.0+）、手动设schema.prisma为Prisma语言模式、项目路径不含中文；否则@relation等语法变灰、CLI语义功能失效。
装对扩展、设对语言模式、路径别含中文，三者缺一高亮就断。
Prisma 扩展必须认准 Prisma Labs 官方发布者
VSCode 市场搜 “Prisma” 会出现多个同名扩展，但只有发布者为 Prisma Labs（蓝底白字 logo）的那个才提供完整语法定义。装错会导致：schema.prisma 文件里 model 关键字能高亮，但遇到 @relation 或 @map 就直接变灰、断在中间；更严重的是和 TypeScript 插件冲突，导致 prisma.user.findMany() 报红。
操作建议：
- 卸载所有非
Prisma Labs发布的 Prisma 相关扩展 - 确认扩展版本 ≥
v5.15.0（命令面板输入Extensions: Show Installed Extensions查看） - 安装后必须彻底退出 VSCode 再重开，不是“重载窗口”
schema.prisma 文件必须手动设为 Prisma 语言模式
即使扩展装对了，VSCode 默认仍把 schema.prisma 当作 Plain Text，右下角状态栏显示 “Plain Text” 就是没生效。这不是 bug，是文件关联未触发。
立即生效方法：
- 打开
prisma/schema.prisma，点击右下角语言标识 →Change Language Mode→ 输入prisma→ 回车选中 - 若文件在子包里（如
packages/api/prisma/schema.prisma），也得单独点一次，VSCode 不会递归匹配
永久生效配置（写进项目根目录 .vscode/settings.json）：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
{
"files.associations": {
"*.prisma": "prisma"
}
}
Windows 中文路径会导致高亮崩溃或卡在 “Loading…”
Prisma 扩展底层调用 Node.js 子进程解析 schema，而 Windows cmd/powershell 对 UTF-8 路径处理不稳定。现象是：高亮闪退、状态栏持续显示 Prisma: Loading…、@id 校验不触发。
这不是 VSCode 或扩展的问题，是 CLI 在中文路径下编码失败。临时解法：
- 把项目移到英文路径下（如
C:\dev\myapp） - 或改用 WSL，在 Linux 环境下开发
注意：files.exclude 或 search.exclude 若误排除了 prisma/ 目录，也会让高亮失效，需检查设置。
高亮正常但字段不提示？那不是高亮问题，是 prisma CLI 没跑起来
语法高亮和智能提示（字段补全、@relation 参数提示、跳转定义）是两套机制。高亮靠扩展的语法定义，而语义功能依赖本地 prisma CLI 启动语言服务器。
验证方式：终端执行 npx prisma --version，输出应类似 prisma 5.12.0（v5+ 推荐）。若报 command not found：
-
pnpm用户用pnpm dlx prisma --version -
yarn用户注意yarn dlx和yarn run的 PATH 差异 - 全局安装过但失效，可删掉
node_modules/.prisma重试
真正容易被忽略的是：高亮只是“看得清”，而字段提示、模型跳转、@relation(references: ) 补全这些，全靠 CLI 进程活着——它一旦挂掉或没启动，VSCode 就只剩颜色了。
