GraphQL语法高亮不生效需依次检查插件安装、文件关联、JS中模板字符串标记及扩展名配置；更新插件、手动切换语法、添加extensions映射并启用enable_jsx_graphql可解决95%问题。
GraphQL语法高亮不生效？先确认插件是否真在运行
Sublime Text 默认不带 GraphQL 支持，装了插件但没反应，大概率是插件没激活或文件关联错了。常见现象是 .graphql 或 .gql 文件打开后全是白色文本，连注释都不变色。
实操建议：
- 用
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux）调出命令面板，输入Install Package，确保已安装GraphQL（作者：princjef）或GraphQL Syntax Highlighting（作者：kumarharsh）——前者更活跃、支持 SDL 和内联查询 - 检查右下角状态栏：打开一个
.graphql文件，看角落是否显示GraphQL；如果显示Plain Text或JSON，点它手动切换到GraphQL - 如果手动切换后高亮正常，说明文件关联失效，需要补配置：菜单 →
View→Syntax→Open all with current extension as...→ 选GraphQL
在 JS/TS 文件里写 GraphQL 模板字符串，怎么让 Sublime 识别？
API 开发中大量使用 gql 标签函数包裹查询，但 Sublime 默认只对独立 .graphql 文件启用语法高亮，JS 里的字符串仍是纯文本。
实操建议：
- 安装插件后，多数新版
GraphQL插件已内置对gql、graphql、/* GraphQL */等标记的支持，但需确认启用：打开Preferences → Package Settings → GraphQL → Settings，检查"enable_jsx_graphql": true是否存在且为true - 模板字符串必须满足格式才触发高亮：
gql`query { user { id } }`可以，但const q = gql`...`中若gql是变量名而非全局函数，可能不识别——这是插件限制，不是 bug - 如仍无效，临时方案：在字符串前加注释标记，例如
/* GraphQL */ gql`...`，部分插件会据此启用解析
自定义 GraphQL 片段或 schema 扩展时，高亮错乱怎么办？
当你在 .graphql 文件里写 directives、custom scalars、union 类型或 @defer/@stream 等新特性，高亮可能突然失效或关键字变白——这是因为语法定义没跟上 spec 更新。
实操建议：
- 优先更新插件：在
Package Control: Upgrade Package里单独升级GraphQL插件，作者 pricjef 近年持续适配 GraphQL Spec 2021+，老版本（v2.x 以下）不支持@live、interface ... implements等写法 - 避免混用缩进风格：Sublime 的语法高亮基于 TextMate 规则，对空格/Tab 敏感。比如
extend type Query {后换行缩进不一致，可能导致后续字段解析失败，表现为字段名不着色 - schema 文件若含大量
scalar DateTime或自定义 directive，可手动在插件设置中追加"additional_scalars": ["DateTime", "JSON"]，否则这些词会被当普通标识符处理
为什么 .gql 文件能高亮，.graphqls 却不行？
很多团队用 .graphqls 存 schema 定义（SDL），但默认插件只绑定 .graphql 和 .gql，.graphqls 被当成未知类型，直接 fallback 到 Plain Text。
实操建议：
- 手动添加文件扩展名映射：菜单 →
Preferences → Settings – Syntax Specific，在打开的 JSON 文件里加一行："extensions": ["graphql", "gql", "graphqls"] - 注意别改错文件：这个设置必须在当前文件是
GraphQL语法时打开（即右下角已显示GraphQL），否则会写入全局用户设置，影响其他语言 - 如果项目还用
.graphqlc（client schema）或.gqlc，一并加进extensions数组即可，无需重启
GraphQL 语法高亮本质依赖插件对 TextMate 语法规则的维护，不是 Sublime 自身能力。只要插件版本够新、文件扩展名和上下文标记对得上，95% 的场景都能稳住——但遇到 directive 嵌套过深或自定义 parser 逻辑，高亮掉帧是常态，这时候别硬调，切回 Plain Text 写完再切回来更省时间。
