必须安装princjef维护的graphql插件，手动绑定.graphql/.gql扩展名，并启用enable_jsx_graphql支持js/ts中gql模板字符串高亮；语法高亮不等于类型校验，需额外配置lsp-graphql实现补全与验证。
GraphQL 语法高亮在 Sublime Text 中不生效，基本可以断定是插件没装对、文件没绑对、JS 里模板字符串没识别这三类问题之一。不是编辑器不行，是配置漏了关键环节。
必须装 princjef 的 GraphQL 插件，别选错作者
Sublime 默认完全不认 GraphQL，必须装对插件。当前最稳定、更新最勤、支持 @defer、@stream 和 interface implements 等新特性的只有 princjef 维护的 GraphQL 插件——别选 GraphQL Syntax Highlighting 或旧版 GraphQL（作者 joshbuddy），它们已停止维护，对 SDL 2021+ 支持不全。
操作步骤：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Install Package→ 选择Package Control: Install Package - 搜索
GraphQL，只认准作者栏写princjef的那一项，点击安装 - 装完必须重启 Sublime Text，否则插件不会加载
手动绑定 .graphql / .gql 扩展名
插件装好了，但打开 schema.graphql 还是纯白文本？右下角状态栏显示 Plain Text 或 JSON？说明文件扩展名没和 GraphQL 语法关联上。这不是 bug，是 Sublime 的默认行为：插件提供语法定义，但不自动接管文件后缀。
操作步骤：
- 打开任意一个
.graphql或.gql文件 - 点击右下角状态栏中显示的当前语言名（比如
Plain Text） - 在弹出菜单中选
Open all with current extension as… - 再从子菜单里找到并点击
GraphQL
此后所有同后缀文件都会自动用 GraphQL 语法解析，高亮立刻可见。
让 JS/TS 里的 gql 模板字符串也高亮
API 开发中大量写 gql`query { user(id: $id) { name } }`，但 Sublime 默认只对独立 .graphql 文件启用高亮，JS 里的字符串仍是灰底白字——这是因为插件需要显式启用 JSX/TSX 内联支持。
操作步骤：
- 打开
Preferences → Package Settings → GraphQL → Settings - 确认用户设置中有
"enable_jsx_graphql": true，没有就手动加一行 -
gql必须是全局函数名或已import的命名导入（如import { gql } from 'graphql-tag'）；若写成const q = gql``，插件无法推断上下文，不会触发高亮 - 临时救急法：在模板字符串前加注释
/* GraphQL */，部分版本插件会据此强制启用解析
LSP-graphql 补全与校验必须单独配
语法高亮 ≠ 类型校验和字段补全。princjef 的 GraphQL 插件只负责高亮和基础语法识别，要获得字段提示、schema 验证、自动补全等能力，必须额外安装并配置 LSP-graphql 和 GraphQL Language Server，并在项目根目录放好 .graphqlconfig 文件。
容易被忽略的地方：
- 即使高亮全绿，
gql`{ user { nonExistentField } }`也不会报错——那是 LSP 层的事 -
enable_jsx_graphql开启后，插件仍只解析字符串内容，不校验 schema 是否存在、字段是否可选 - 若你改过
.sublime-syntax或自定义了 scope，LSP 可能因 scope 不匹配而拒绝注入服务
