VSCode中GraphQL查询发不出去，首要检查右下角语言模式是否为GraphQL、Output面板GraphQL通道是否有“No endpoint configured”等错误、.graphql文件顶部是否含正确endpoint注释、服务端是否运行，再确认schema是否成功加载并显示“GraphQL: connected”。
VSCode 里 GraphQL 查询根本发不出去，怎么定位？
不是代码写错了，八成是插件没连上后端——VSCode 自己不执行查询，只负责把 query 或 mutation 发给服务器。发不出去，第一反应不是改语法，而是查连接链路。
- 右下角语言模式必须是
GraphQL，不是Plain Text；点它手动切一次，再确认files.associations设置里有"*.graphql": "graphql" - 打开
Output面板（Ctrl+Shift+U），选GraphQL通道，看有没有No endpoint configured或Network error - 如果用的是
GraphQL Request插件，检查 .graphql 文件顶部有没有# GraphQL Request: http://localhost:4000/graphql这类注释；缺了就发不出 - 服务端是否真在运行？用
curl -X POST http://localhost:4000/graphql --data '{"query":"{__typename}"}'直接测，绕过 VSCode
为什么字段补全不出现，或者提示“Cannot query field”？
补全是靠 schema 驱动的，不是靠语法猜的。没有有效 schema 关联，插件就只能高亮，不能提示字段、校验类型。
- 必须装
GraphQL for VSCode（Prisma 维护），禁用Apollo GraphQL、GraphQL Language Service等干扰插件 -
graphql.config.js或.graphqlrc必须放在项目根目录，且schema字段指向真实可用的源：schema: "./schema.graphql"（SDL 格式）或schema: "http://localhost:4000/graphql" - Windows 用户注意：YAML 配置中路径统一用正斜杠
/，别用\；./schema.graphql中的./会被忽略，直接写schema.graphql - schema 更新后，右键任意 .graphql 文件 →
Reload GraphQL Schema，否则补全是旧的
变量总报 “Variable \"$id\" is not defined”，怎么填才对？
GraphQL 插件对变量声明和传值是强约束的。匿名查询不带变量声明，带变量就必须显式定义 + 显式传值，两头缺一不可。
- 查询里写了
$id: ID!，就得在插件的GraphQL Variables面板里填{"id": "1"}，格式必须是合法 JSON，不能是{id: "1"}或id="1" - 用
GraphQL Request插件时，变量块要单独写在查询下方，用variables注释标记：# GraphQL Request: http://localhost:4000/graphql query GetUser($id: ID!) { user(id: $id) { name } } # variables {"id": "1"} - 如果用的是
Thunder Client，变量得塞进请求体 JSON 的variables字段里，不是 URL 参数
调试 resolver 层逻辑，VSCode 能不能断点？
能，但不是在 .graphql 文件里断点——那是声明，不是执行。断点要打在后端 resolver 函数里，比如 Node.js 的 resolvers.js 或 TypeScript 的解析器实现中。
- 确保后端启动时加了
--inspect标志：node --inspect ./server.js - VSCode 的
.vscode/launch.json配置 type 为node，request 为attach，port 对应--inspect启的端口（默认 9229） - 在 resolver 函数内部设断点，发起 GraphQL 请求（比如用 VSCode 插件发，或 curl），请求走到该 resolver 时就会暂停
- 注意：前端发的 query 不会触发后端断点，除非你连的是本地正在 debug 的服务；连线上 endpoint 就无效
GraphQL 的编辑体验高度依赖插件与后端的耦合状态，而不是单点配置。最容易被忽略的是 schema 加载是否成功——Output 面板里没报错，不代表 schema 已加载；右下角显示 GraphQL: connected 才算真正通了。
