WebStorm 2025.3+ 原生支持 GraphQL，无需安装插件；装插件会覆盖原生语言定义导致高亮失效，应卸载插件并手动配置模板字符串注入和 *.gql 文件类型关联。
WebStorm 自带 GraphQL 支持，不需要额外安装插件——装了反而可能冲突或覆盖原生功能。
为什么装了 GraphQL 插件反而没高亮？
WebStorm 2025.3+（含当前 2026.2 版本）已内置完整 GraphQL 支持，包括 SDL、查询/变更语法、gql 模板字符串注入、schema 验证等。手动安装第三方 GraphQL 插件（如社区版）会干扰 Language Injection 规则，导致 gql`query { ... }` 不识别、.gql 文件变纯文本、甚至报错 “Language injection already registered”。
- 现象：装完插件后，右下角状态栏显示 Plain Text，
Alt + Enter没有Inject language or reference → GraphQL选项 - 根本原因：插件注册了同名语言 ID，覆盖了 WebStorm 原生 GraphQL 语言定义
- 解决动作：卸载所有 GraphQL 相关插件 → Settings → Plugins → 搜索
GraphQL→ 点卸载 → 重启 IDE
怎么启用 WebStorm 原生 GraphQL 高亮？
关键不是“装”，而是“激活注入”和“绑定文件类型”。原生支持默认关闭字符串注入，且不认 .gql 扩展名。
- 让
gql`...`字符串生效：光标进入反引号内任意位置 → 按Alt + Enter（macOS 是⌥ + ⏎）→ 选Inject language or reference → GraphQL - 自动注入常用模板：Settings → Editor → Language Injections → 点
+→ Pattern 填gql，Language 选GraphQL（仅对 JS/TS 模板字符串有效） - 让
.gql文件高亮：Settings → Editor → File Types → 找到GraphQL类型 → 在 Registered Patterns 里加*.gql（注意不是.graphql，后者默认已支持） - 验证是否成功：新建
test.gql，写type Query { hello: String }—— 若关键字变蓝、花括号有匹配高亮，说明已生效
为什么 .graphql 有高亮但 .gql 没有？
WebStorm 默认只将 .graphql 和 .graphqls 关联到 GraphQL 文件类型，.gql 被归类为 Text，所以不触发任何语法解析。这不是 bug，是 JetBrains 的默认策略——他们认为 .gql 更常用于 JS 中的标签函数，而非独立 schema 文件。
- 别试图把
.gql绑到 Text 或 JSON 类型下：那样只会得到注释高亮或 JSON 校验，不是 GraphQL 语义 - 如果项目强制用
.gql存 schema，必须手动加到 GraphQL 类型的 Registered Patterns，否则字段补全、directive 提示、schema 导航全部失效 - 注意冲突：如果其他插件（如 Vue 或 Svelte）也注册了
*.gql，需在 Text 类型下删掉它，否则优先级抢占会导致注入失败
真正容易被忽略的是：Language Injection 必须在字符串内容内部触发，而不是在 gql 函数名上；且 gql 必须是全局变量名（不能是 const gql = graphql; 后再用），否则 WebStorm 不识别为模板标签函数。
