GraphQL字段补全失效时，须先确认右下角显示“GraphQL: connected”，再检查插件是否为GraphQL for VSCode、graphql.config.yml路径是否正确（相对于配置文件位置）、.graphql文件语言模式是否手动设为GraphQL、gql模板是否单独成行且命名合法。
GraphQL查询字段补全失效时怎么救
GraphQL字段补全依赖语言服务（如 GraphQL for VS Code 或 Apollo GraphQL 插件），但常因 schema 未加载或配置错误而失效。不是所有 gql 字符串都会被识别——只有被插件明确标记为 GraphQL 的代码块才触发补全。
检查点：
- 确保文件后缀是 .graphql 或 .gql，或在 JS/TS 文件中使用带标签模板字面量：gql`query { ... }`
- 若用 Apollo，确认项目根目录下有 apollo.config.js 或 graphql.config.yml，且已正确指向 schema 和 endpoint
- 补全不出现？先按 Ctrl+Space 手动唤出建议（Mac 注意系统输入法冲突，见下文）
- 某些插件（如 GraphQL Language Service）需重启 VS Code 才加载 schema 变更
快速生成 query/mutation 模板的 snippet 触发方式
ES7 React/Redux/GraphQL/React-Native snippets 插件提供开箱即用的 GraphQL 片段，但前缀命名不直观，容易输错。
常用触发前缀：
- gqlq → 生成带 query 标签的空查询（含变量占位）
- gqlm → 生成 mutation 模板，自动带 input 参数结构
- gqls → subscription 模板，含 onCompleted 和 onError 占位
- gqlf → 定义 fragment，支持复用字段集
注意：
- 输入前缀后必须按 Tab，不是 Enter 或空格
- 若片段没展开，检查插件是否启用、当前语言模式是否为 GraphQL（右下角状态栏查看）
- 片段中变量名默认用 $id、$input，光标会停在可编辑位置，直接覆盖即可
多字段对齐与缩进的批量操作技巧
GraphQL 查询中字段常横向铺开，手动对齐易出错；嵌套层级深时缩进混乱，影响可读性。
高效做法：
- 选中全部字段（如从 { 到 } 内容），按 Shift+Alt+F 自动格式化（需 GraphQL 插件支持 Prettier 或内置 formatter）
- 若字段名长度不一，想垂直对齐冒号（如 id:、name:、createdAt:），用 Ctrl+D 逐个选中冒号前空格，再统一补空格或 Tab
- 更稳的方式：选中字段块 → Ctrl+Shift+P → 输入 “Align” → 选 Align by : (colon) 命令（需安装 Align 插件）
- 缩进错乱？把光标放在某行首，按 Ctrl+] 或 Ctrl+[ 单步调整，比拖动 Tab 更精准
Mac 上 Ctrl+Space 被系统占用怎么办
Mac 默认用 Ctrl+Space 切换中英文输入法，这会拦截 VS Code 的智能提示触发，导致 GraphQL 字段补全弹不出。
必须改系统设置：
- 进入「系统设置 → 键盘 → 输入源」
- 关闭「按下 Control-Space 以切换输入法」选项
- 改完后，VS Code 中 Ctrl+Space 就能正常唤出字段建议了
- 不要试图用 Cmd+Space 替代——那是 Spotlight，和编辑器无关
- 如果仍无效，检查是否有其他输入法工具（如搜狗、鼠须管）在后台劫持该快捷键
GraphQL 查询效率瓶颈往往不在写法本身，而在 schema 加载、补全响应、模板复用这三个环节卡住。插件装了不等于生效，快捷键设了不等于可用——关键得让编辑器“认出这是 GraphQL”，再让补全“知道字段在哪”。
