VSCode格式化文档快捷键是什么_VSCode一键美化代码【手册】-VSCode-PHP中文网

VSCode默认格式化快捷键为Shift+Alt+F（Win/Linux）或Shift+Option+F（macOS），但需满足语言模式正确、对应格式化扩展已安装并配置editor.defaultFormatter、且编辑器处于焦点状态才生效。

vscode格式化文档快捷键是什么_vscode一键美化代码【手册】

VSCode 默认格式化文档快捷键是 Shift+Alt+F（Windows/Linux）或 Shift+Option+F（macOS），但它不是“按了就一定起作用”的万能键——是否生效，取决于当前文件的语言模式、是否有可用格式化器、以及焦点是否在编辑器内。

为什么按了 `Shift+Alt+F` 没反应？

最常见原因不是快捷键失效，而是 VSCode 根本没“认出”你在编辑什么语言，或者没装能干活的格式化工具。

右下角状态栏显示 Plain Text 或 Unsupported → 点击它，手动选 JavaScript、Python、JSON 等对应语言
语言模式正确但提示 “No formatter found” → 检查是否安装了对应插件：esbenp.prettier-vscode（JS/TS/HTML/CSS）、ms-python.black-formatter（Python）、vscode-sql-beautify（SQL）
快捷键在终端、设置页、搜索框里按下必然无效 → 它只在编辑器有焦点时触发，when 条件是 editorTextFocus

`editor.defaultFormatter` 必须配对语言设置

即使装了 Prettier，VSCode 也不会自动把它用在所有文件上；它需要明确知道“哪种语言该交给谁来格式化”。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

全局设置 "editor.defaultFormatter": "esbenp.prettier-vscode" 只对部分语言生效（如 JS/TS），对 Python、JSON 等可能被忽略

推荐按语言块配置，例如：

"[javascript]": {
  "editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[json]": {
  "editor.defaultFormatter": "vscode.json-language-features"
},
"[python]": {
  "editor.defaultFormatter": "ms-python.black-formatter"
}

若项目根目录有 .prettierrc 或 pyproject.toml，确保其中 tabWidth 与 VSCode 的 editor.tabSize 一致，否则格式化后可能被编辑器自动重排

JSON 和 CSS 这类“内置支持语言”的特殊处理

VSCode 对 JSON、CSS、HTML 等语言自带轻量格式化器，不依赖插件也能工作，但容易被误关或覆盖。

JSON：必须语言模式为 JSON（不是 JSONC），且 json.format.enable 为 true（默认开启）
CSS：若未装 Prettier，默认会调用 vscode.css-language-features；但若已设 editor.defaultFormatter 为 Prettier，则需确保该插件已启用并支持当前文件类型（如 .scss 需额外确认）
注意：某些插件（如 SQL Beautify）使用不同快捷键 —— Alt+Shift+L 是 DDL 专用格式化，和通用 Shift+Alt+F 不互通

真正卡住人的地方，往往不是快捷键记错，而是语言模式没切对、格式化器没指定到具体语言块、或者多个插件争抢 defaultFormatter 导致静默失败。检查右下角、打开命令面板搜 Format Document With、再看输出面板里 Output → Log (Window) 的报错，比反复重装插件更有效。