vscode 本身不执行 graphql 查询，需安装插件（如 graphql.vscode-graphql）并配置 endpoint（如 http://localhost:4000/graphql）才能发送请求；必须有 operation name（如 query getuser）、正确 schema 关联及语言模式设为 graphql，否则提示“no endpoint configured”或变量未定义。
GraphQL 查询在 VSCode 里直接运行不了，得靠插件和后端配合
VSCode 本身不解析或执行 GraphQL 查询，它只负责编辑和发送请求。真正执行查询的是你连接的 GraphQL 服务器（比如本地 http://localhost:4000/graphql 或线上 endpoint）。没有运行时环境，Ctrl+Enter 或右键“Send Request”只会报错或无响应。
必须装 GraphQL 插件 + 配置 endpoint 才能发请求
推荐安装 GraphQL by Prisma（ID: graphql.vscode-graphql）或 GraphQL for VSCode（已归档，不建议新项目用）。装完后需手动指定服务地址：
- 在工作区根目录创建
.graphqlrc或graphql.config.js -
.graphqlrc示例：{\n "schema": "./schema.graphql",\n "documents": "./src/**/*.graphql",\n "extensions": {\n "endpoints": {\n "default": {\n "url": "http://localhost:4000/graphql",\n "headers": {\n "Authorization": "Bearer xxx"\n }\n }\n }\n }\n} - 如果没配
endpoints，插件根本不知道往哪发请求，Alt+Shift+P → GraphQL: Send Query会提示 “No endpoint configured”
写查询时要带 operation name，否则部分插件不识别
很多插件（尤其是旧版）依赖 operationName 判断是否为有效查询。纯片段或匿名查询（如 { user(id: "1") { name } }）可能被忽略或报语法警告。
- 正确写法：
query GetUser($id: ID!) {\n user(id: $id) {\n id\n name\n email\n }\n} - 必须有
query/mutation关键字 + 名称，不能省略 - 变量定义（
$id: ID!）可选，但若用了变量，必须同时提供GraphQL Variables面板填值，否则报Variable "$id" is not defined
调试失败时先看 Network 和错误位置标记
插件发送失败不会弹大红框，而是静默失败或在右下角状态栏闪一下。真出问题得查两处：
- 打开 VSCode 的
Output面板（Ctrl+Shift+U），选择GraphQL通道，看是否有Network error或Parse error - 检查当前文件是否被识别为 GraphQL：右下角语言模式应显示
GraphQL，不是Plain Text；如果不是，点击右下角语言标签手动选GraphQL - 常见错误：
Cannot connect to server（endpoint 地址错或服务没开）、Unexpected token（少括号/花括号）、Validation error（字段不存在或类型不匹配）
endpoint 配错、没启服务、查询语法缺 operation name——这三个是新手卡住最久的地方。
