webstorm需手动将.graphql文件识别为graphql schema才能提供字段提示：先安装js graphql插件，再在file types中添加*.graphql模式，右键文件override file type为graphql，并确保graphql.config.js中schema字段路径正确且文件为合法sdl。
WebStorm 能识别 GraphQL Schema 文件并提供字段提示，但必须手动告诉它“这个文件是 Schema”，否则它只当普通文本。
怎么让 .graphql 文件被识别为 Schema
WebStorm 默认只把 .graphql 和 .graphqls 当作 GraphQL 文件类型，但不会自动判断它是 Schema 还是 Query。Schema 提示依赖 IDE 明确知道“这是类型定义”，而不是随便一个查询字符串。
- 确保已安装官方
JS GraphQL插件（Settings → Plugins → 搜索并启用） - 打开
Settings → Editor → File Types，找到GraphQL类型 - 在
Registered Patterns里加一行：*.graphql（如果还没加）和*.graphqls（推荐也加上） - 关键一步：右键点击你的
schema.graphql文件 →Override File Type → GraphQL，否则即使后缀匹配，也可能被误判为 Plain Text
为什么 graphql.config.js 配了 schema 却没提示
WebStorm 会读 graphql.config.js，但只认标准字段名。常见配置错误会导致它根本不去加载 Schema。
- 路径必须是相对项目根目录的，比如
./src/schema.graphql，不能用../或绝对路径 - 字段名必须是
schema，不是schemas或typeDefs—— WebStorm 不解析 JS 变量，只按约定字段提取 - 如果是 HTTP 地址，如
http://localhost:4000/graphql，需确保服务正在运行且返回的是合法 SDL（无 GraphiQL HTML 页面） - 改完配置后要重启 WebStorm 或执行
File → Reload project from disk，否则缓存不更新
Template string 里写 query 怎么触发字段提示
光有 Schema 文件还不够，JS/TS 中的字符串必须被注入 GraphQL 语言，IDE 才能关联类型。
- 光标停在模板字符串内部（比如
gql`{ user { id }`的{ user { id }区域），按Alt + Enter（macOS 是⌥ + ⏎）→Inject language or reference → GraphQL - 想省事？进
Settings → Editor → Language Injections→ 点+→Pattern填gql，Language选GraphQL（仅对 JS/TS 模板字符串生效） - PHP 或纯字符串拼接（如
"{ user { id } }"）无法自动注入，必须手动 Alt+Enter，且 PHP 中不支持字段跳转 - 如果用了
graphql-tag或gql函数，确保函数名在Language Injections里注册过，否则注入失效
Fragment 分离后怎么保持提示链路不断
把 fragment 抽到独立 .graphql 文件里，WebStorm 默认不解析 #import 语法，所以跨文件引用会断掉提示。
-
#import是graphql-import等工具的运行时行为，WebStorm 不执行它，只读原始文件内容 - 正确做法：所有 fragment 文件也加进
graphql.config.js的schema数组，例如：["./src/schema.graphql", "./src/fragments/*.graphql"] - 确保 fragment 文件本身是合法 SDL（以
fragment开头，有on类型），否则 WebStorm 解析失败，整块提示失效 - 如果 fragment 依赖其他 fragment，顺序无关紧要，但所有文件都得在
schema列表里显式列出，不能靠 glob 自动发现
最常被忽略的是 override file type 和 graphql.config.js 字段名硬编码——这两处一错，后面所有提示都是镜花水月。
