VSCode中Shift+Alt+F（Windows/Linux）或Shift+Option+F（macOS）默认格式化整个文档，不自动降级为选区格式化；真正用于选区格式化的命令是editor.action.formatSelection，对应快捷键为Ctrl+K Ctrl+F（Win/Linux）或Cmd+K Cmd+F（macOS），其生效依赖语言模式正确、格式化扩展已安装启用且支持formatRange协议。
Shift+Alt+F（Windows/Linux）或 Shift+Option+F（macOS）在选中代码时，确实只格式化选区——但这个行为不是“默认开启”，而是强依赖语言支持、插件配置和选区语义。很多用户按了没反应，不是快捷键错了，是环境没配对。
为什么选中后按 Shift+Alt+F 没反应？
VSCode 的 Shift+Alt+F 命令本质是 editor.action.formatDocument，它**不会自动降级为格式化选区**。真正起作用的是另一个命令：editor.action.formatSelection。该命令是否可用，取决于当前语言模式下激活的格式化器是否实现了 formatRange 协议。
- 打开命令面板（
Ctrl+Shift+P），输入Format Selection—— 如果没这个选项，说明当前语言不支持范围格式化 - 右下角语言标识显示为
Plain Text或Markdown时，Format Selection必然不可用（这两类语言无原生格式化器） - Python 用户常见于装了
ms-python.python但没启用black或autopep8；JS/TS 用户若只装 ESLint 插件却没开eslint.format.enable，也会失效 - 键盘布局干扰：某些非美式键盘（如法语 AZERTY）下
Alt键位映射异常，可改用命令面板手动触发Format Selection
Ctrl+K Ctrl+F 是更稳的“选区格式化”入口
这个组合键绑定的是 editor.action.formatSelection 命令本身，不依赖 Shift+Alt+F 的降级逻辑，属于“直连通道”。只要语言支持 formatRange，它就有效。
- 必须先完成选中（哪怕只选一个字符），再按
Ctrl+K Ctrl+F；松开第一个Ctrl+K后不要移动光标，立刻按Ctrl+F - 它比
Shift+Alt+F更适合自动化场景，比如配合宏插件或自定义键位 - 如果
Ctrl+K Ctrl+F也无效，问题一定出在语言支持层，不是快捷键冲突
选中什么，才真的被格式化？
VSCode 不按“视觉行”或“鼠标拖选范围”理解选区，而是把选区交给语言服务器做语法解析。选得不准，格式化就“漏掉”或“多包”。
- 想格式化单行？用
Ctrl+L（Windows/Linux）或Cmd+L（macOS）精准选中整行（含换行符），再按Ctrl+K Ctrl+F - 想格式化一个函数体？把光标放在函数名上，按
Ctrl+Shift+ArrowRight逐级扩展选区（函数 → 类 → 文件），比鼠标拖可靠得多 - 在 Markdown 中格式化代码块？必须先选中
```js和```之间的纯代码内容（不含围栏标记），再临时切换右下角语言为JavaScript，然后执行Ctrl+K Ctrl+F - JSX 中一个跨多行的 props 对象，用鼠标拖选“看起来是一块”，但实际只选中了部分 token —— 此时格式化结果可能错乱，应改用
Ctrl+Shift+ArrowRight扩展到完整对象字面量
绕过语言限制的临时方案
当 Format Selection 确实不可用（比如老版本插件、冷门语言），又不想全文件格式化，可借助 VSCode 内置能力模拟：
- 用
Ctrl+Shift+P运行Editor: Copy With Syntax Highlighting（如有），粘贴到新临时文件，切对应语言，全文件格式化后再复制回来（适合小段） - 安装
emeraldwalk.runonsave插件，配置保存时调用外部脚本（如prettier --stdin-filepath .js），配合多光标选中 +Ctrl+C/Ctrl+V实现“伪选区格式化” - 最简方式：选中 →
Ctrl+X剪切 → 新建空白文件 →Ctrl+V粘贴 → 切语言 →Shift+Alt+F→Ctrl+A Ctrl+C→ 回原文件Ctrl+V（别嫌麻烦，比改 settings.json 快）
真正卡住人的，从来不是快捷键记不住，而是不知道「VSCode 格式化选区」这件事，本质上是一次语言服务器发起的、带语法上下文的远程调用——它需要对、要准、得稳。随便拖一段代码按下去就期望整齐，反而最容易掉进空响应、错格式、半生效的坑里。
