必须完成三件事：安装princjef版GraphQL插件、手动绑定.graphql/.gql后缀、在JS/TS中启用JSX支持并确保gql为全局函数名，缺一不可实现高亮。
Sublime Text 装了 GraphQL 插件却还是白底黑字？不是插件没装，而是三件事没做全：GraphQL（princjef 版）必须装对、.graphql 文件后缀必须手动绑定、JS 里的 gql 模板字符串必须显式启用 JSX 支持——漏掉任一环，高亮就失效。
怎么确认装的是正确版本的 GraphQL 插件
Sublime 默认不带 GraphQL 支持，装错插件等于没装。当前唯一持续维护、支持 @defer、@stream、interface implements 等新语法的，只有 princjef 维护的 GraphQL 插件。旧版 GraphQL (joshbuddy) 或 GraphQL Syntax Highlighting 已停更，对 SDL 2021+ 解析错误率高。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）调出命令面板 - 输入
Install Package→ 选Package Control: Install Package - 搜索
GraphQL，只认准作者栏写princjef的那一项 - 安装完成后必须重启 Sublime Text，否则插件不会加载
为什么 .graphql 文件打开还是 Plain Text
插件提供语法定义，但 Sublime 不会自动把 .graphql 或 .gql 后缀关联过去——这是默认行为，不是 bug。右下角显示 Plain Text 就等于没生效，哪怕插件已装好。
- 打开任意一个
schema.graphql或query.gql文件 - 点击右下角状态栏显示的语言名（大概率是
Plain Text） - 选
Open all with current extension as…→ 再选GraphQL - 如果项目里混用
.gql，对.gql文件重复一次该操作 - 确认状态栏显示
GraphQL，且#注释、query、type关键字有颜色区分
JS/TS 里 gql`query { }` 为什么还是灰底白字
Sublime 默认只解析独立文件，JS 中的模板字符串被当作普通字符串处理。要让它识别，得靠插件的 JSX 上下文支持，且配置和写法都得合规。
- 打开
Preferences → Package Settings → GraphQL → Settings - 确保用户设置里有
"enable_jsx_graphql": true -
gql`query { user { id } }`这种直接调用能触发高亮；但const q = gql``中若gql是局部变量或重命名导入（如import { graphql as gql }），插件无法推断，大概率不生效 - 临时救急：在模板字符串前加
/* GraphQL */注释，例如/* GraphQL */ gql`query { }`
高亮错乱或关键字变白的常见原因
不是代码写错了，而是语法引擎跟不上 Spec 更新或格式不规范。princjef 的 v3.x+ 插件已适配 GraphQL Spec 2021+，但缩进、注释风格等细节仍会影响解析。
- 升级插件：用
Package Control: Upgrade Package单独升级GraphQL插件 - 避免混用缩进：比如
extend type Query {后换行缩进不一致，可能导致后续字段名不着色 - 只用
#注释，别写//—— 否则整个块可能被跳过解析 -
gql必须是全局可识别的函数名，不能是局部变量、解构赋值结果或动态 import 的别名
最容易被忽略的是状态栏语言标识和插件配置的联动关系：只要右下角没显示 GraphQL，就等于语法层没接入；而 JS 里的高亮开关藏在插件设置里，不是开箱即用，也从不自动开启。
