能配，但必须分清 node 环境和 graphql 服务是两件事：node 是运行时，graphql 是你写的 api 或用的客户端能力；混配易致 schema 连接失败，node 环境无需配置只需验证，vscode 依赖系统 path 找 node/npm，macos 从 dock 启动需手动补全 path，launch.json 中 runtimeexecutable 应用绝对路径或留空，必须安装并重启 graphql for vscode 插件（prisma 维护），禁用 apollo 等干扰插件，graphql.config.yml 需放项目根目录且路径正确（windows 用正斜杠），ts/js 中 gql 模板须独占一行、标签名匹配并全局声明类型，schema 更新后需手动右键“reload graphql schema”。
能配，但必须分清 Node 环境和 GraphQL 服务是两件事：Node 是运行时，GraphQL 是你写的 API 或用的客户端能力。混在一起配，十有八九连不上 schema。
Node.js 环境本身只需验证不需“配置”
VSCode 不负责提供 Node 运行环境，它只调用你系统里已装好的 node 和 npm。所谓“配置”，其实是确认 VSCode 能正确找到它们：
- 打开终端（
Ctrl+`），执行node -v和npm -v，必须有输出；没输出说明 PATH 没设好，重装 Node.js 时勾选Add to PATH最稳 - VSCode 默认继承系统 PATH，但如果你用的是 macOS 的 LaunchServices 启动（比如从 Dock 点开），可能拿不到 shell 的 PATH——这时在 VSCode 设置里搜
terminal integrated env，加一条："terminal.integrated.env.osx": {"PATH": "/opt/homebrew/bin:/usr/local/bin:${env:PATH}"}（路径按你实际 brew 或 node 安装位置改） - 调试时选错运行时：启动配置
launch.json里runtimeExecutable别写成node_modules/.bin/ts-node这种相对路径，优先用绝对路径或留空让 VSCode 自动找
GraphQL for VSCode 插件必须单独装且重启生效
不是装了“GraphQL”就完事。VSCode 市场里叫 GraphQL 的插件有十几个，真正能连 schema、补全字段、跳转定义的只有 GraphQL for VSCode（Prisma 团队维护）。其他如 GraphQL Language Service 已废弃，装了反而让 .graphql 文件变 Plain Text，高亮和补全都崩。
- 装完必须 完全重启 VSCode（不是重载窗口），否则右下角永远不显示
GraphQL: connected - 打开任意
.graphql文件，右下角语言模式必须是GraphQL，不是Plain Text；如果不是，手动在settings.json加："files.associations": {"*.graphql": "graphql", "*.gql": "graphql"} - 禁用所有其他 GraphQL 相关插件，尤其是
Apollo GraphQL（它专注 client 代码生成，不负责编辑器内补全）
schema 路径写错 = 补全失效，且零提示
插件靠 graphql.config.yml 找 schema，但路径是相对于该配置文件所在位置，不是项目根目录。写错就等于没配，你只会发现字段不提示、Ctrl+Click 灰掉、悬停没类型——VSCode 从不报错。
- 把
graphql.config.yml放项目根目录，内容至少含：schema和documents字段；例如：{ "schema": "schema.graphql", "documents": ["src/**/*.{ts,tsx,js,jsx,graphql,gql}"] } -
schema路径别带./（YAML 解析器会忽略它），也别写src/schema.graphql（除非 config 文件也在src里） - Windows 用户必须用正斜杠：
schema: "schema/schema.graphql"，反斜杠\是 YAML 转义符，会导致解析失败 - 如果用的是
schema.json（introspection 输出），配置里就得明确写"schema": "schema.json"；插件默认不认schema.graphql这种 SDL 格式
TS/JS 里 gql 模板字符串要补全，得满足三个硬条件
插件默认只识别独立成行、标签名匹配、AST 可解析的模板字面量。写法稍偏，补全立刻消失。
- 必须单独一行：
const query = gql`{ user { id } }`；不能拼接：gql`` + '{ user { id } }'，也不能嵌在对象里：query: gql`...` - 标签名默认只认
gql和graphql；如果用了别的（比如query），得在settings.json声明："graphql.taggedTemplateLiteralName": ["gql", "graphql", "query"] - TypeScript 项目必须全局声明
gql类型，否则返回类型退化为any；在src/@types/graphql.d.ts里加：import { DocumentNode } from 'graphql'; declare module 'graphql-tag' { export function gql(strings: TemplateStringsArray): DocumentNode; }
最常被忽略的是：schema 更新后，VSCode 不会自动 reload。改了 schema.graphql 或重启了后端服务，必须右键任意 .graphql 文件 → “Reload GraphQL Schema”，否则编辑器里还是旧字段。
