Prisma VS Code 扩展与编辑器集成

安装

在 VS Code 扩展市场搜索 "Prisma"，安装 Prisma 扩展（发布者 prisma.io）。

安装后 VS Code 会识别 .prisma 文件，自动启用所有功能。

核心功能

语法高亮与实时类型检查

• .prisma 文件里不同颜色区分关键字、类型、属性、字符串
• 红色波浪线 — Schema 语法错误或类型不匹配，悬停看详细报错信息
• 黄色波浪线 — 非致命警告（比如未使用的模型、不符合 Prisma 风格的命名）

这是 Prisma 开发里最有价值的工具之一——手写出错的 Schema 太常见了，编辑器实时提示能省掉很多跑 prisma validate 才发现错误的时间。

自动格式化

Prisma 有固定的格式化规则（类似 Go 的 gofmt），没有配置项：

• 配置块里 = 号对齐
• 字段定义按类型和属性列对齐
• 块属性（@@map、@@unique）移到块末尾
• 换行重置对齐

快捷键：Shift+Alt+F（VS Code 默认格式化快捷键），或保存时自动格式化（在 VS Code 设置里勾选 Format On Save）。

也可以手动跑 CLI：

npx prisma format

悬停提示

鼠标悬停在 Schema 里的任意 token 上，会显示：

• 字段类型和可空性
• 属性的含义（比如 @default(autoincrement()) 会解释自增行为）
• 关联字段指向的目标模型
• 枚举值列表

自动补全

输入时：

• 输入 @ 提示可用的字段属性（@id、@unique、@default、@relation 等）
• 输入 @@ 提示可用的块属性（@@unique、@@index、@@map 等）
• 输入 model 提示快速创建新 model 模板
• 输入 @relation(fields: [ ... 时提示当前 model 的字段

schema.prisma 文件定位

如果你的 Schema 不在默认的 prisma/schema.prisma，在 .vscode/settings.json 里配置：

{
  "prisma.schemaPath": "./path/to/schema.prisma"
}

Prisma Studio 快捷入口

右键 .prisma 文件或编辑区空白，菜单里有 "Open Studio" 直接启动 Studio 并打开浏览器。

命令面板

按 Ctrl+Shift+P 打开命令面板，搜索 "Prisma" 可用的命令：

• Prisma: Generate Client
• Prisma: Migrate Dev
• Prisma: Open Studio
• Prisma: Validate Schema
• Prisma: Format Document

同时用多个 Schema

一个项目里可能有多个 .prisma 文件（不同的数据库、不同的 Prisma 版本）。Prisma 扩展支持：

• 每个文件独立的语法检查
• 在文件顶部用 // prisma: no-format 注释跳过格式化
• VS Code 设置里 prisma.schemaPath 可以指定多个路径

其他编辑器支持

Neovim 配置参考

如果你用 Neovim + nvim-lspconfig：

-- ~/.config/nvim/lua/plugins/prisma.lua
return {
  {
    'neovim/nvim-lspconfig',
    opts = {
      servers = {
        prismls = {},
      },
    },
  },
}