必须安装Prisma出品的GraphQL for VSCode插件并彻底重启VSCode，正确配置graphql.config.yml（路径相对于该文件所在目录）、手动设置.graphql文件语言模式为GraphQL，三者缺一不可，否则字段补全、Ctrl+Click跳转和类型悬停均静默失效。
VSCode 本身不提供 GraphQL Schema 类型定义的快捷键级补全能力——所有字段提示、类型悬停、Ctrl+Click 跳转，都依赖 GraphQL for VSCode 插件 + 正确配置的 Language Server。快捷键只是触发入口，背后全是配置是否生效。
装哪个插件才让 Ctrl+Click 真能跳转到 type 定义
必须装 GraphQL for VSCode（作者 Prisma），其他名字带 “GraphQL” 的插件，比如 GraphQL Language Service 或旧版 Apollo GraphQL，要么已归档，要么会把状态栏卡在 GraphQL: disconnected，Output 面板反复报 Unable to load schema from。装错等于没装。
- 装完必须彻底关闭所有 VSCode 窗口再重开——
Developer: Reload Window不起作用，Language Server 根本不会启动 - 打开任意
.graphql文件，右下角语言模式必须显示GraphQL，不是Plain Text；若仍是 Plain Text，手动在settings.json加："files.associations": {"*.graphql": "graphql", "*.gql": "graphql"} - 状态栏出现
GraphQL: connected才算真正连上 schema，此时悬停字段才有类型，Ctrl+Click 才能跳转到type User或input CreatePostInput定义处
graphql.config.yml 路径写错，补全就静默失效
插件靠这个文件定位 schema，但路径解析规则反直觉：它是相对于 graphql.config.yml 所在目录，不是项目根目录，也不是当前编辑的文件位置。写错就等于没配，VSCode 也不会报错，你只会发现字段不提示、跳转灰掉。
-
./schema.graphql中的./会被 YAML 解析器忽略，等价于schema.graphql；写成src/schema.graphql就错了（除非 config 文件也在src/里） - Windows 用户禁用反斜杠：
schema\schema.graphql是非法 YAML，必须写schema/schema.graphql - 多文件 schema 必须用数组：
schema: ["schema/types.graphql", "schema/queries.graphql"] - 远程 endpoint 写法：
schema: http://localhost:4000/graphql，但需确保服务已启、CORS 开放、introspection 未禁用，否则 Output 面板只显示静默失败
JS/TS 里写 gql 模板，为什么字段不补全
插件默认只识别 gql`` 和 graphql`` 这两种字面量前缀。但实际项目中，绝大多数人是 import { gql } from '@apollo/client'，VSCode 根本不知道这个 gql 是 GraphQL 片段，补全和校验全部失效。
- 必须在
settings.json显式声明："graphql.taggedTemplateLiteralName": ["gql"] -
gql模板字符串需单独成行，且不能被变量包裹或拼接，例如const q = gql`{ user { name } }`是支持的，但const q = someFn(gql`{ user { name } }`)就无法识别 - 如果用的是
graphql函数名，也要加进数组："graphql.taggedTemplateLiteralName": ["gql", "graphql"]
补全失效时，唯一能看懂的线索在 Output 面板
Language Server 出错时，VSCode 界面零提示：不弹窗、不标红、不报错。你只会发现“没补全”“跳转灰掉”“字段标红但点不开”。这时候必须打开 Output 面板（Ctrl+Shift+U），下拉菜单选 GraphQL，看日志里有没有 Starting language server 后的报错。
- 常见静默失败点：
schema文件路径错、文件不存在、YAML 格式非法（比如用了\）、远程 endpoint 返回401/403、introspection 被禁用 - 即使
schema.graphql存在，如果它没包含完整 SDL（比如漏了directive或scalar定义），部分字段也可能不提示 - 本地 schema 更新后，插件不会自动 reload，需要手动重启 VSCode 或等待几秒——但别指望它自动感知改动
最常被忽略的不是快捷键，而是 graphql.config.yml 路径是否真相对于它自己所在目录，以及 Output 面板里那几行没人看的日志。补全失效时，90% 的问题藏在这两个地方。
