GraphQL语法高亮失效的三大原因是插件未装对、文件扩展名未绑定、JS/TS中模板字符串未启用内联支持；必须安装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+ 支持不全。
操作步骤：
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
- 按
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 语法解析，高亮立刻可见。如果项目同时用 .gql，也需同样操作绑定一次，避免部分插件对 .gql 支持不全。
让 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 补全与校验必须单独配
语法高亮 ≠ 类型校验和字段补全。只装插件不配 LSP，补全/校验静默失败，且几乎不报错提示。
关键点：
- 先装
LSP主框架（通过 Package Control 安装LSP） - 再装
LSP-graphql插件 - 项目根目录需有
.graphqlconfig或graphql.config.js，其中schemaPath必须指向可读的 SDL 文件（路径错、含 BOM、权限不足都会导致补全失效） - JS/TS 文件默认不监听，需在
.graphqlconfig中显式声明extensions或在 LSP 设置中添加"graphql"到enabled_languages
补全是否生效，唯一可靠判断是：在 .ts 文件中输入 gql`query { user { <cursor> } }`，光标后能弹出字段建议。否则就是 LSP 配置未穿透到 JS/TS 上下文——这点最容易被忽略。
