必须装graphql for vscode（prisma维护）、配graphql.config.yml路径（相对该文件、用正斜杠）、手动设.graphql/.gql为graphql语言模式，三者缺一不可；否则补全静默失效，仅output面板graphql日志可诊断。
装对插件、配对路径、设对语言模式，三者缺一不可；只装插件不配置，gql 里敲 user 不会补全，VSCode 也不会报错，只会静默失效。
只装 GraphQL for VSCode（Prisma 官方维护）这一个插件
其他名字带 “GraphQL” 的插件——比如已归档的 GraphQL Tools、Apollo GraphQL 旧版、甚至 GraphQL by GraphQL Foundation——都可能让状态栏卡在 GraphQL: disconnected，或报 Unable to load schema from。装完必须重启 VSCode（不是重载窗口），否则 Language Server 压根不启动。
确认装对：打开任意 .graphql 文件，右下角应显示 GraphQL: connected；悬停字段能看到类型，Ctrl+Click 可跳转定义。
graphql.config.yml 路径必须写对，且用正斜杠
路径是相对于 graphql.config.yml 所在目录，不是工作区根目录，也不是当前文件位置。./schema.graphql 中的 ./ 会被 YAML 解析器忽略，直接写 schema.graphql 更稳妥。
- Windows 用户禁用反斜杠：
schema\schema.graphql是非法 YAML，必须写schema/schema.graphql - 多文件 schema 需用数组：
schema: ["schema/types.graphql", "schema/queries.graphql"] - 远程 endpoint 写法：
schema: http://localhost:4000/graphql，但服务必须已启动、允许 CORS、且未禁用 introspection（否则静默失败）
.graphql 和 .gql 文件必须手动设为 GraphQL 语言模式
VSCode 不会自动识别后缀，即使插件已装好。右下角显示 Plain Text 就等于关掉了所有智能能力。
- 点右下角语言标识 → 选
GraphQL - 或在
settings.json中加："files.associations": {"*.graphql": "graphql", "*.gql": "graphql"} - 若在 TS/JS 中用
gql模板字面量，还需加："graphql.taggedTemplateLiteralName": ["gql"]
补全失效时，Output 面板是唯一诊断入口
Language Server 出错时，VSCode 界面零提示：不弹窗、不标红、不报错，你只会发现“没补全”“跳转灰掉”“字段标红但点不开”。这时候必须打开 Output 面板（Ctrl+Shift+U），下拉菜单选 GraphQL，看日志里有没有 Starting language server 后的报错。
常见静默失败点：schema 文件路径错、文件不存在、YAML 格式非法、远程 endpoint 返回 401/403、introspection 被禁用——这些都不会在编辑器里显式提示，全靠 Output 面板暴露。
