VSCode支持选中代码后按Shift+Alt+F（Windows/Linux）或Shift+Option+F（macOS）仅格式化选区，前提是语言格式化器支持range formatting且已启用对应扩展。
选中代码后按快捷键就能格式化
VSCode 默认支持对选中区域单独格式化，不需要全文件操作。关键在于触发格式化命令时有选中文本——只要光标在选区内或文本已高亮，Shift+Alt+F（Windows/Linux）或 Shift+Option+F（macOS）就会只处理选中部分，而不是整个文件。
这个行为依赖当前语言的格式化器是否支持「range formatting」。主流语言如 JavaScript、TypeScript、Python、JSON 都支持；但某些自定义语言或老旧插件可能只提供全文格式化能力，此时选中后仍会格式化整文件。
- 确认格式化器已启用：检查右下角语言模式（如
JavaScript），点击可切换并确保对应格式化扩展已安装（如Prettier、ESLint、Black） - 避免误触：如果没选中任何内容却按了格式化快捷键，VSCode 会默认格式化整个文件
- 部分格式化器（如
prettier）需在配置中显式开启范围支持："prettier.rangeFormatting": true（新版已默认开启）
用命令面板手动调用「Format Selection」
当快捷键失效或想确认行为时，直接调用专用命令更可靠。VSCode 内置命令 editor.action.formatSelection 专为选区设计，不依赖快捷键绑定是否生效。
操作路径：Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）→ 输入 Format Selection → 回车。即使当前语言格式化器不响应快捷键，该命令仍会尝试调用支持 range 的后端。
- 该命令在设置中可被禁用：检查
settings.json是否有"editor.formatOnSave": false等干扰项（它不影响手动触发） - 某些语言（如
HTML）需注意嵌套结构：选中<div>标签内部文本时，格式化可能因解析边界不明确而缩进异常 - 若命令不可见，说明当前语言未注册 range formatter，需检查对应扩展是否启用或更新
通过右键菜单快速触发
鼠标右键选中区域，在上下文菜单里能看到 Format Selection 选项。这是最直观的触发方式，适合不确定快捷键或刚接触 VSCode 的用户。
但要注意：该菜单项是否出现，取决于当前激活的语言模式和已启用的格式化扩展。例如，打开一个无后缀的纯文本文件，右键不会显示该选项；而打开 .ts 文件且已装 ESLint 插件，则大概率可见。
- 右键菜单项名称固定为
Format Selection，不是Format Document—— 后者才是整文件格式化 - 部分插件（如
Beautify）不提供右键菜单入口，只响应快捷键或命令面板，需以插件文档为准 - 在多光标编辑状态下，右键菜单可能消失或行为异常，建议单选后再操作
格式化失败常见原因与排查
选中后按快捷键没反应、报错或格式化结果不符合预期，通常不是 VSCode 本身问题，而是链路中某环缺失或冲突。
command 'editor.action.formatSelection' not found
这类错误说明 VSCode 找不到可用的 range formatter。常见情况：
- 当前文件没识别出语言模式（右下角显示
Plain Text），需点击手动选择，如JSON、Python - 对应语言的格式化扩展未安装，或已禁用（检查扩展面板中状态）
- 项目根目录存在
.editorconfig或prettier.config.js，但配置语法错误，导致 formatter 初始化失败 - VSCode 设置中关闭了格式化功能：
"editor.formatOnSave": false不影响手动格式化，但"editor.formatOnPaste": false等不会干扰选区格式化
真正容易被忽略的是：某些格式化器（如旧版 js-beautify）根本不支持 range formatting，它会静默退回到整文件格式化——你以为格式了选区，其实改了全部。
