GraphQL语法高亮失效主因是插件未装对、文件扩展名未绑定、JS中gql模板字符串未启用内联支持；须安装princjef插件、手动绑定.graphql/.gql后缀、开启"enable_jsx_graphql": true。
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 补全与校验必须单独配
语法高亮 ≠ 类型校验和字段补全。要实现 query { user { __typename id na| } 输入时自动提示 name、email 等字段，必须上 LSP（Language Server Protocol）+ LSP-graphql，且 schema 路径不能错。
- 先装
LSP，再装LSP-graphql；只装后者没用，LSP 主框架缺位会导致服务静默失效 - 项目根目录建
graphql.config.yml，写明schema: ./src/schema.graphql（路径必须相对项目根，且schema.graphql文件得真实存在、UTF-8 无 BOM、只用#注释） - 要在
.js文件里获得补全，配置里还得加includes: ["**/*.js"]，否则 LSP 只扫描.graphql文件 - 改完配置或更新了 schema，必须手动执行
LSP: Restart Servers，LSP 不会热重载
最容易被忽略的是：LSP-graphql 对路径错误、文件缺失、编码异常这些情况全部静默失败——它不会报错，也不会提示你哪里错了，只会让你一直以为“补全就是不工作”。验证是否真跑起来，最直接的办法是看 .graphql 文件右下角状态栏是否显示 LSP-graphql，而不是只有 GraphQL。
