Shift+Alt+F（Windows/Linux）或 Shift+Option+F（macOS）是 VSCode 默认格式化快捷键，但需满足语言模式正确、安装对应格式化扩展、远程环境插件就绪、键位映射准确等前提才生效。
Shift+Alt+F（Windows/Linux）或 Shift+Option+F（macOS）是 VSCode 默认的「格式化文档」快捷键，但它不是按下就一定生效的万能键——它只在满足前提条件时才真正干活。
为什么按 Shift+Alt+F 没反应？
这不是快捷键坏了，而是 VS Code 找不到能执行格式化的“人”：
- 右下角语言模式显示为
Plain Text：说明文件没被识别成对应语言，先检查后缀名（如.js写成.txt），或点击状态栏手动选对语言模式 - 缺少格式化扩展：比如
.ts文件没装esbenp.prettier-vscode或 ESLint 插件；.py文件没装ms-python.python（它内置black支持） - 远程开发场景（SSH/WSL）：格式化插件必须装在远程环境里，本地装了无效
- Mac 外接 Windows 键盘：系统把
Option映射为Alt，但 VS Code 实际收到的键码可能不匹配，可改用命令面板（Ctrl+Shift+P）搜Format Document测试是否可用
Ctrl+K Ctrl+F 是怎么实现局部格式化的？
这个组合键专用于「格式化选中代码」，行为更稳定，不依赖语言模式是否“完美识别”：
- 只要存在文本选区、且当前语言有支持
formatRange能力的格式化器，就会触发范围格式化 - 常见失效场景：插件未实现
formatRange（如某些老版 Python 插件只支持全文件格式化）、.vue文件中<script>块被识别为JavaScript但格式化器没设为默认 - 别指望
Shift+Alt+F自动降级为局部格式化——它不会 fallback，要么全文件，要么跳过
如何让 .vue 或 .html 真正格式化出来？
Vetur 和 Volar 的处理逻辑完全不同，配错就白按：
- Vetur（Vue 2 主流）：
vetur.format.defaultFormatter.html默认是prettier，但它对 Vue 指令（如v-if）支持弱，建议改成js-beautify-html - Volar（Vue 3 官方推荐）：完全不读 Vetur 配置，走 Prettier；此时要检查
prettier.config.js或 VS Code 的html.format.*设置（如html.format.wrapLineLength） - 同时装了 Prettier 和 Beautify：VS Code 可能卡在“选谁”，必须显式指定
editor.defaultFormatter，例如设为esbenp.prettier-vscode
保存时自动格式化，但别和 ESLint 打架
开 editor.formatOnSave 很方便，但和 ESLint 的 eslint --fix 共存时容易互相覆盖规则：
- 分工要明确：Prettier 管样式（缩进、括号、空格），ESLint 管质量（未定义变量、潜在 bug）
- 禁用 Prettier 对 ESLint 已管项的控制，比如在
prettier.config.js中设"semi": false、"singleQuote": false - 把修复动作交给 ESLint：
"editor.codeActionsOnSave": { "source.fixAll.eslint": true }，而不是靠 format - 别开
editor.formatOnPaste：粘贴一段 JSX 或模板语法时，自动重排常破坏结构语义
真正起作用的从来不是快捷键本身，而是背后那套“语言识别 → 格式化器加载 → 能力匹配 → 规则协同”的链路。任何一个环节断掉，Shift+Alt+F 就只是个安静的按键。
