graphql插件不提示字段结构，大概率是schema未加载成功；需检查graphql.config.js配置路径是否正确、schema文件格式是否为sdl、服务是否启动并响应，且修改后必须重载vscode窗口。
GraphQL 插件不提示字段结构？大概率 schema 没加载成功
VSCode 的 GraphQL 插件（如 GraphQL.vscode-graphql）本身不带 schema，只做语法着色；字段级高亮、自动补全、跳转定义这些能力，全依赖插件能否读到你的 GraphQL schema。没看到字段名提示、IntelliSense 灰掉、右键“Go to Definition”失效——不是插件装错了，而是它根本不知道你的 Query 类型里有哪些字段。
常见错误现象：
- 文件右下角显示 “GraphQL”，但输入
query {后无任何字段建议 - 手动敲出字段名，结果标红报错：
Cannot query field "user" on type "Query" - 点击字段名无法跳转到 schema 定义位置
核心原因：插件找不到 schema 文件或 endpoint，配置路径写错、格式不对、服务未响应，都会导致静默失败。
必须在项目根目录配 graphql.config.js 或 graphql.config.yml
这是唯一被主流插件（GraphQL.vscode-graphql、GraphQL for VSCode）共同识别的配置入口。不能只靠 files.associations 绑定后缀，那只能启用基础语法高亮。
推荐用 graphql.config.js（更易写条件逻辑）：
{<br> schema: "./schema.graphql",<br> documents: ["src/**/*.graphql", "src/**/*.ts"]<br>}
关键点：
-
schema必须指向合法 SDL 格式文件（不是 introspection JSON），内容以type Query { ... }开头 - 若 schema 来自本地开发服务，可写
schema: "http://localhost:4000/graphql"，但需确保服务已启动且返回 200 + 支持 introspection -
documents字段告诉插件哪些文件要参与类型检查，不填则只有.graphql文件受校验
字段提示失效的三个高频陷阱
即使配置了 config 文件，仍可能白屏无提示。以下三点最常被忽略：
-
schema.graphql路径是相对项目根目录的，不是相对于 config 文件——比如 config 在packages/api/下，但schema.graphql在packages/api/schema.graphql，那路径就得写"./schema.graphql"，不能写"../api/schema.graphql" - VSCode 不会自动重载 config 变更，改完必须执行
Ctrl+Shift+P→ 输入Developer: Reload Window，否则旧缓存仍在 - 插件读取 schema 是同步过程，如果
schema指向 HTTP 地址但服务响应慢或超时（默认 5s），插件就放弃加载，不会报错，只会静默退化为纯语法模式
验证 schema 是否真被加载：看右下角状态栏小图标
装好插件、配好 config、重启窗口后，打开任意 .graphql 文件，在 VSCode 窗口右下角状态栏找一个微小的 GraphQL 图标（通常是紫色方块）。鼠标悬停上去，应显示类似 Schema loaded from ./schema.graphql 或 Schema loaded from http://...。
如果只显示 GraphQL 文字，没有 schema 加载信息，说明插件压根没读到 schema —— 此时别调前端代码，先回 config 和路径查起。
真正难调试的，从来不是语法写错，而是 schema 这一层的连接断在无声处。
