VS Code中格式化整篇代码的快捷键：Windows/Linux为Shift+Alt+F，macOS为Shift+Option+F；需确保语言模式正确、有可用格式化器且配置无冲突。
按什么键能立刻格式化整篇代码
Windows/Linux 是 Shift + Alt + F，macOS 是 Shift + Option + F —— 这是 VS Code 默认绑定的「格式化文档」快捷键，不依赖扩展也能用（只要文件类型被正确识别）。
但注意：它只在当前语言模式有可用格式化器时才真正生效。比如打开一个没后缀的纯文本文件，或 .html 文件但没装任何 HTML 格式化扩展，VS Code 会弹提示让你选一个格式化工具，而不是直接格式化。
- 如果按键没反应，先看右下角语言模式是否正确（如显示“Plain Text”就点它改成“HTML”或“TypeScript”）
- 快捷键冲突很常见——某些输入法（尤其是中文输入法）会劫持
Alt + Shift组合，可临时切换英文输入法再试 - Ubuntu 系统用户偶尔会遇到
Ctrl + Shift + I被桌面环境占用，建议统一用Shift + Alt + F并确认设置里没被覆盖
为什么有时候按了没变化，或者格式错乱
根本原因不是快捷键失效，而是 VS Code 不知道该用谁来格式化。它不会自己猜，必须明确指定一个默认格式化器（editor.defaultFormatter）。
常见错误现象：Shift + Alt + F 后缩进变 4 空格、属性换行全崩、Vue 单文件组件里的 <template> 块被当成普通 HTML 处理……这些基本都是格式化器选错或配置打架导致的。
- TypeScript/JavaScript 文件推荐设为
esbenp.prettier-vscode（Prettier 扩展） - 纯 HTML 或老项目可选内置
vscode.html-language-features，更轻量但规则固定 - Vue 项目务必配合
vetur（已弃用）或volar，否则<script setup>和<style scoped>会被格式错 - 别在全局设置里硬塞
js-beautify-html——它已多年未维护，对现代语法支持极差
怎么让保存时自动格式化，又不踩坑
开启 editor.formatOnSave 很方便，但容易引发协作问题：有人开、有人关，结果同一份代码每次保存都来回变样。
真正靠谱的做法是项目级约束，而不是个人偏好：
- 在项目根目录建
.vscode/settings.json，写入：{"editor.defaultFormatter": "esbenp.prettier-vscode", "editor.formatOnSave": true} - 同时配
.prettierrc（哪怕只有{"semi": false, "singleQuote": true}），否则 Prettier 用默认规则，和团队不一致 - 禁用「格式化粘贴」（
editor.formatOnPaste）——它常把复制来的代码强行重排，反而破坏语义结构 - 如果用了 ESLint + Prettier 双校验，务必装
eslint-plugin-prettier并关闭 Prettier 的重复检查，否则保存时反复报错
选中部分代码也能格式化吗
可以，但不是所有格式化器都支持——Prettier 支持，VS Code 内置 HTML 格式器不支持选中范围格式化。
实操上更可靠的方式是：先用 Ctrl + A 全选，再按 Shift + Alt + F；或右键菜单点「格式化选择内容」（前提是当前格式化器支持该能力）。
- Vue / Svelte / JSX 文件中，单独格式化
<template>块基本无效，因为解析器需要上下文 - 想只格式化 JS 表达式（比如
{{ foo.bar() }}里的内容），得靠 ESLint 的format命令，不是Shift + Alt + F - 命令面板输入
Format Selection看是否可用，比盲按快捷键更稳妥
最常被忽略的一点：格式化行为最终由「当前打开文件的语言模式 + 已启用的扩展 + 项目级配置」三方共同决定，缺一不可。别只盯着快捷键，先确认右下角那个小标签是不是你想要的语言。
