GraphQL在Sublime中需装插件、绑文件类型、配语言服务器才能实现高亮、补全、校验和格式化；仅装插件不配置会导致打开.graphql文件仍为白底黑字，正确标志是状态栏显示GraphQL且语法元素有颜色区分。
装对插件、绑对文件类型、配好语言服务器，GraphQL 在 Sublime 里才能真正“活”起来——高亮不是目的，而是补全、校验、格式化的前提。光装插件不配置，90% 的人卡在第一步：打开 .graphql 文件还是白底黑字。
怎么确认 GraphQL 语法高亮已生效？
别信“装了就完事”。真实判断依据只有两个：右下角状态栏显示 GraphQL，且注释、关键字（query/mutation/type）、花括号、字段名有明显颜色区分。常见失效现象包括：
- 打开
.graphql文件后全是白色，连# 注释都不着色 - 状态栏显示
Plain Text或JSON - 手动点击状态栏切换成
GraphQL后高亮正常 → 这说明文件关联丢失，不是插件问题
实操建议：
- 用
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux）调出命令面板，输入Install Package，安装GraphQL（作者princjef）——它比GraphQL Syntax Highlighting更活跃，支持 SDL 和内联查询 - 打开一个
.graphql文件，点右下角语言标识，选Open all with current extension as… → GraphQL - 如果项目里混用
.gql，也需同样操作绑定一次，避免部分插件对.gql支持不全
JS/TS 里写 gql`...` 为什么没高亮？
Sublime 默认只对独立 .graphql 文件启用语法解析，JS 中的模板字符串仍是纯文本——这不是 bug，是插件默认行为。能否识别，取决于插件是否启用了 JS 上下文支持。
实操建议：
- 打开
Preferences → Package Settings → GraphQL → Settings，确认存在且启用"enable_jsx_graphql": true -
gql`query { user { id } }`这种写法能触发高亮；但const q = gql``中若gql是局部变量而非全局函数，插件大概率不识别——这是 TextMate 语法引擎的限制，无法绕过 - 临时救急：在模板字符串前加
/* GraphQL */注释，例如/* GraphQL */ gql`query { ... }`，部分插件会据此切换解析器
为什么补全/校验不工作？LSP-graphql 配置关键点
语法高亮只是表层，补全和 schema 校验必须走 LSP（Language Server Protocol）。只装 LSP-graphql 不行，它依赖 LSP 主框架，且必须正确声明 schema 路径——路径错、文件不可读、编码含 BOM，都会静默失败，不会报错提示。
实操建议：
- 先装
LSP，再装LSP-graphql；装完重启 Sublime，然后Cmd+Shift+P输入LSP: Enable Language Server Globally，勾选graphql - 项目根目录建
graphql.config.yml，内容至少包含：projects: default: schema: ./src/schema.graphql路径必须相对于项目根目录（即你通过Project → Add Folder to Project加入的文件夹），不能用$HOME或通配符 -
schema.graphql必须是合法 SDL（如type Query { ... }），不能含 JS 风格注释（//），必须 UTF-8 无 BOM - JS/TS 中要支持
gql`...`补全，需在 config 中显式添加includes：includes: - "**/*.js" - "**/*.ts"
格式化 GraphQL 查询总失败？--parser graphql 是命门
Sublime 原生不支持 GraphQL 格式化。靠 JsPrettier 实现时，漏掉 --parser graphql 这个参数，Prettier 就会把你的查询当 JS 字符串解析，结果可能是整段缩进错乱、大括号换行异常，甚至删掉字段名。
实操建议：
- 确保本地已安装 Prettier CLI：
npm install -g prettier，并在JsPrettier设置中填对prettier_cli_path - 在
JsPrettier设置中加入："additional_cli_args": { "--parser": "graphql" }这个参数必须显式写出，不能省略 -
custom_file_extensions必须包含"graphql"和"gql"，否则.graphql文件根本不会触发 JsPrettier - JS 中的内联查询要格式化，需满足：字符串前有
gql标签 +JsPrettier已启用enable_jsx_graphql
最常被忽略的是：LSP-graphql 启动后，如果改了 graphql.config.yml 或更新了 schema.graphql，必须手动重启 LSP 服务（Cmd+Shift+P → LSP: Restart Servers），否则补全和校验永远卡在旧版本。
