shift+alt+f 在 vscode 中格式化 graphql 查询需满足三条件：1. 文件关联为 graphql 语言（配置 files.associations）；2. 存在有效的 graphql.config.js（含 schema 和 documents）；3. 查询位于 .graphql/.gql 文件或合规的 gql 模板字符串中。
Shift+Alt+F 是 GraphQL 查询语句在 VSCode 中触发格式化的最直接快捷键——但前提是它真能生效。很多人按了没反应，不是快捷键错了，而是 GraphQL 语言上下文根本没加载成功。
为什么 Shift+Alt+F 对 .graphql 文件没反应？
VSCode 默认不识别 .graphql 或 .gql 文件为 GraphQL 语言，右下角显示 “Plain Text” 就是铁证。格式化器压根不会启动。
- 手动点右下角语言标识 → 选 “GraphQL”（临时生效，重启后丢失）
- 更可靠的做法：在
settings.json中加"files.associations": {"*.graphql": "graphql", "*.gql": "graphql"} - 改完必须全量重启 VSCode 窗口（
Ctrl+Shift+P→Developer: Reload Window不够）
GraphQL 格式化只认 graphql.config.js，不读 .prettierrc
即使你装了 prettier-plugin-graphql，VSCode 的 GraphQL 插件（如 GraphQL.vscode-graphql）也不会读取 Prettier 配置。它只依赖项目根目录下的 graphql.config.js 提供的上下文。
-
graphql.config.js必须存在，且至少含schema和documents字段 - 示例：
module.exports = { schema: "./schema.graphql", documents: "./src/**/*.{graphql,gql}" } - Windows 用户注意：路径用正斜杠
"./schema.graphql"，别用反斜杠 - 远程 schema（如
"http://localhost:4000/graphql"）需确保服务开启 introspection 且未被 CORS 拦截
HTTP 文件里写 GraphQL 查询，Shift+Alt+F 依然无效
.http 或 .rest 文件即使内容是合法 GraphQL，VSCode 也默认不解析为 GraphQL 语言——这是设计行为，不是 bug。语法高亮、格式化、补全全部失效。
- 想让查询可格式化，得把 query 单独抽到
.graphql文件中 - 或者用 REST Client 插件发送请求时，把 query 当纯文本处理，不依赖格式化功能
- 若坚持在
.http文件中编辑，可用Ctrl+K Ctrl+F尝试选区格式化，但效果取决于当前语言模式（通常是 plain text，基本无作用）
JS/TS 里的 gql 模板字符串无法格式化或提示？
插件默认只识别独立成行、字面量调用的 gql 标签。任何变形都会断连类型系统和 schema。
- ✅ 正确：
const query = gql`query GetUser($id: ID!) { user(id: $id) { name } }`; - ❌ 失效：
const q = gql`` + ''、graphql`...`、myQuery`...`、嵌在对象属性里如{ query: gql`...` } - 需安装
graphql-tag并在tsconfig.json中加"types": ["graphql-tag"] - 自定义标签名（如
query）需在settings.json中显式声明："graphql.taggedTemplateLiteralName": ["gql", "query"]
Shift+Alt+F 就只是个安静的按键。
