VSCode 配合核心插件与合理配置即可高效开发 GraphQL：必备 GraphQL for VSCode、GraphQL Config 和快捷片段插件；需本地化 Schema 实现智能补全；GraphQL Request 插件支持内联调试；辅以小配置可显著提效。

vscode 是 graphql 开发中非常高效的选择，关键不在于装得越多越好，而在于选对几个核心插件 + 配合合理的项目配置，就能获得智能补全、类型校验、请求调试等完整体验。

必备插件：轻量但精准

以下插件在真实项目中验证过稳定性与实用性，避免冗余功能干扰：

• GraphQL for VSCode（Prisma 官方维护）：支持 .graphql / .gql 文件语法高亮、文档内字段跳转、Schema 引用提示；需配合本地 schema 文件或 introspection JSON 使用。
• GraphQL Config：自动识别项目根目录下的 graphql.config.js 或 graphqlrc，统一管理端点、schema 路径、文档位置，是多环境协作的基础。
• ES7+ React/Redux/React-Native snippets（或类似 JS/TS 快捷片段插件）：快速生成带 gql 标签的模板，比如输入 gqlf 回车即可插入带 fragment 的查询结构。

Schema 管理：本地化才能真正智能

VSCode 的 GraphQL 插件默认不联网，必须显式提供 Schema 才能做字段校验和自动补全。常见做法有两种：

• 运行 npx graphql-cli download-schema http://localhost:4000/graphql 把当前后端 Schema 导出为 schema.graphql，放在项目 src/graphql/ 下，并在 graphql.config.js 中指向它。
• 使用 Apollo Client 项目时，可配合 @apollo/client 的 codegen 工具生成 TypeScript 类型 + 内联 Schema，VSCode 插件会自动识别生成的 __generated__/ 目录。

调试与测试：不用切出编辑器

写完查询别急着切到 GraphiQL 或 Postman —— VSCode 可直接发送请求并查看响应：

• 安装 GraphQL Request 插件（注意不是 “GraphQL” 同名旧插件），选中一段 gql 查询，右键选择 “Run GraphQL Query”，自动读取配置中的 endpoint 并发送。
• 响应结果以可折叠 JSON 形式内嵌在编辑器底部面板，支持点击字段跳转到对应 Schema 定义（前提是 Schema 已正确加载）。
• 搭配 dotenv 和环境变量配置，可在不同分支下自动切换 dev/staging 端点，无需手动改 URL。

进阶建议：小配置，大提升

几个容易忽略但明显提效的设置项：

• 在 settings.json 中开启："graphql.schemaPath": "./src/graphql/schema.graphql"，避免每次都要靠 config 文件识别。
• 启用 "editor.quickSuggestions": { "strings": true }，让 gql 模板字符串内也能触发字段补全。
• 用 Prettier + prettier-plugin-graphql 统一格式化 .graphql 文件，保持团队查询风格一致。

基本上就这些。不需要复杂工作流，把 Schema 接入、插件配准、请求调试三步走稳，VSCode 就能成为你写 GraphQL 最顺手的 IDE。