Sublime Text中GraphQL高亮失效需四步解决：一、用Package Control安装princjef的GraphQL插件；二、手动将.graphql/.gql扩展名绑定至GraphQL语法；三、在用户设置中启用enable_jsx_graphql并规范gql模板字符串格式；四、升级插件至v3.x以上、统一缩进、仅用#注释。

如果您在 Sublime Text 中打开 .graphql 或 .gql 文件，发现所有文本均为纯白色、注释无颜色、关键字未高亮，则说明 GraphQL 语法支持尚未生效。以下是实现 GraphQL 查询语句高亮的具体操作步骤：

一、安装官方推荐的 GraphQL 插件

Sublime Text 默认不内置 GraphQL 语法定义，必须通过 Package Control 安装兼容性强、持续维护的插件。当前最稳定且支持 SDL、内联查询与最新语法特性的插件是 GraphQL（作者：princjef），它已适配 GraphQL Spec 2021+，包括 @defer、@stream、interface implements 等特性。

1、按下 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS） 调出命令面板。

2、输入 Install Package，选择 Package Control: Install Package。

3、在搜索框中输入 GraphQL，从结果中选择并安装 GraphQL（princjef）。

4、安装完成后，关闭并重新启动 Sublime Text，确保插件完全加载。

二、手动绑定文件扩展名至 GraphQL 语法

即使插件已安装，若 .graphql 或 .gql 文件未被正确识别为 GraphQL 类型，状态栏仍会显示 Plain Text，导致高亮失效。此问题源于文件扩展名未与 GraphQL 语法定义关联。

1、打开任意一个后缀为 .graphql 或 .gql 的文件。

2、观察编辑器右下角状态栏，若显示 Plain Text、JSON 或其他非 GraphQL 的标识，点击该文字。

3、在弹出菜单中选择 Open all with current extension as…。

4、在子菜单中搜索并点击 GraphQL。

5、此后所有同扩展名的文件将自动以 GraphQL 语法解析，高亮立即生效。

三、验证并修复 JS/TS 中 gql 模板字符串高亮

API 开发中常在 JavaScript 或 TypeScript 文件中使用 gql 标签函数包裹查询语句，但 Sublime 默认仅对独立 .graphql 文件启用高亮。需确认插件是否启用 JSX/TSX 内嵌支持，并满足语法标记规范。

1、打开 Preferences → Package Settings → GraphQL → Settings。

2、在右侧用户设置中添加或确认存在以下配置项："enable_jsx_graphql": true。

3、确保模板字符串格式符合识别规则：必须以全局函数名 gql 开头，且紧接反引号，例如 gql`query { user { id } }`；避免写成 const q = gql`` 或拼接形式。

4、若仍不生效，可在字符串前添加注释标记：/* GraphQL */ gql`...`，部分版本插件据此强制启用解析。

四、排查高亮错乱与关键字变白问题

当在 .graphql 文件中编写 directives、custom scalars、union 类型或新 directive（如 @live）时出现高亮中断或字段名未着色，通常因语法定义规则未覆盖最新 spec，或缩进/空格格式触发 TextMate 解析器异常。

1、检查插件版本：通过 Package Control: Upgrade Package → GraphQL 升级至最新版（v3.x 及以上），旧版 v2.x 不支持 interface implements 等语法。

2、统一缩进风格：确保 extend type Query { 后续字段缩进一致，全部使用空格或全部使用 Tab，禁止混用。

3、避免非法注释：SDL 文件中仅允许 # 注释，禁止使用 JS 风格的 // 注释 或块注释 /* ... */，否则可能导致后续行解析失败。