graphql高亮失效的三大原因：插件未装对（仅princjef版graphql插件支持spec 2021+）、文件未绑定语法（需手动设为graphql）、jsx内联查询未启用（需设置"enable_jsx_graphql": true）。
GraphQL 语法高亮在 Sublime Text 中不生效，基本就是插件没装对、文件没认准、或者 JSX 模板字符串没开支持——三者缺一不可。
装对插件：只认 GraphQL（princjef 版）
Sublime 默认不带 GraphQL 支持，必须手动装。别搜“GraphQL Syntax Highlighting”或“GraphQL by prisma”，那些要么停更、要么只支持旧版 SDL。当前唯一稳定且兼容 Spec 2021+（含 @defer、@stream、interface implements）的是 GraphQL 插件，作者 princjef。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Install Package，选中Package Control: Install Package - 搜索
GraphQL，确认作者是princjef，安装 - 装完必须重启 Sublime，否则插件不加载
- 重启后打开任意
.graphql文件，右下角状态栏应显示GraphQL；若仍为Plain Text，说明绑定失败，跳到下一步
绑定扩展名：点右下角 Plain Text 手动设为 GraphQL
插件装了 ≠ 文件被识别。Sublime 不会自动把 .graphql 或 .gql 关联到新语法，得人工指定。这是高亮失效最常见原因。
- 打开一个
query.graphql文件 - 看右下角状态栏文字，如果是
Plain Text，直接点击它 - 选
Open all with current extension as…→ 搜索并选GraphQL - 如果菜单里没有
GraphQL选项，说明插件未生效（重装/重启）或根本没装 - 推荐统一用
.graphql后缀；.gql在部分插件里支持不全，容易掉高亮
启用 JSX 内联查询：enable_jsx_graphql 必须开
如果你在 JS/TS 文件里写 gql`{ user { id } }` 这类模板字符串，光装插件还不够——默认不处理内联语法。必须显式开启支持。
- 菜单栏
Preferences → Package Settings → GraphQL → Settings – User - 添加这一行：
"enable_jsx_graphql": true - 保存后，确保模板字符串标记是
gql（小写）、且后面紧跟反引号（`）；写成GQL或用双引号会失效 - 缩进必须统一（空格 or tab），混用会导致高亮中断
- 注释只能用
#，//或/* */在 gql 字符串里不被识别为注释
验证和排障：状态栏和错误现象是关键线索
别靠“看起来像不像”判断是否成功。Sublime 的 GraphQL 支持非常依赖状态栏提示和具体报错位置。
- 打开
.graphql文件，右下角显示GraphQL→ 基础高亮 OK；若显示LSP-graphql→ 补全/校验也已就绪（需另配 LSP） - JS 文件中
gql`{`后没高亮？检查enable_jsx_graphql是否为true，以及光标是否在反引号内部 - 关键字（
query、type）没颜色，但注释有颜色？大概率是缩进混乱或用了//注释 - 装了
LSP-graphql但补全不弹出？先确认LSP主框架已装，并在命令面板运行LSP: Enable Language Server Globally勾选graphql
真正容易被忽略的，是 enable_jsx_graphql 这个开关——它默认关闭，而且没有 UI 入口，只能改 JSON 设置；很多人卡在这一步，反复重装插件却没效果。
