“格式化选定内容”失效是因为格式化器未启用或不支持rangeFormatting能力，如旧版Prettier插件、缺少本地Prettier可执行文件或requireConfig配置错误；不同语言依赖对应formatter的range支持程度。
选中代码格式化（即“格式化选定内容”）失效，基本是因为 VS Code 没有为当前语言启用支持局部格式化的格式化器，或者该格式化器本身不实现 rangeFormatting 能力。
为什么 Shift+Alt+F 全文能用，但右键「格式化选定内容」灰色或报错？
VS Code 的「格式化选定内容」功能依赖格式化扩展显式声明对 rangeFormatting 的支持。不是所有 formatter 都提供这个能力——比如内置的 vscode.typescript-language-features 支持，但某些旧版 esbenp.prettier-vscode（v12 之前）或未配置 CLI 路径的 prettier 本地安装会静默降级为只支持全文格式化。
- 现象：右键菜单里「格式化选定内容」置灰，或弹出
There is no formatter for 'javascript'-files installed.（即使全文格式化正常） - 本质：VS Code 查询的是
documentRangeFormattingProvider，而非documentFormattingProvider - 验证方式：打开命令面板（
Ctrl+Shift+P），输入Format Selection，看是否可触发；若不可用，说明 provider 缺失
prettier-vscode 局部格式化必须满足的三个条件
你装了 esbenp.prettier-vscode，不代表它就能格式化选中部分。它需要同时满足：
- 插件版本 ≥ v13.0.0（2025 年后发布，正式启用
rangeFormatting） - 项目根目录下存在可用的
prettier可执行文件（本地node_modules/.bin/prettier优先；全局安装需确保PATH在 VS Code 启动时生效） - 没有被
"prettier.requireConfig": true卡住：如果设了该选项但项目里没.prettierrc或prettier.config.js，插件会拒绝加载，连带 range 格式化也失效
Python / TypeScript 等语言的局部格式化实操差异
不同语言的底层 formatter 对 range 支持程度不同，不能一概而论：
-
Python：用ms-python.python+black时，需确保python.formatting.provider设为black，且 black 版本 ≥ 23.10.1（支持--stdin-filename和行范围参数）；否则选中格式化会 fallback 到全文或失败 -
TypeScript：默认内置 formatter（vscode.typescript-language-features）原生支持 range，无需额外插件；但一旦你把editor.defaultFormatter强制设为esbenp.prettier-vscode，就完全交由 Prettier 控制——它能否局部格式化，就取决于上面说的那三件事 -
HTML / Vue：esbenp.prettier-vscode对块内选中内容支持有限；建议配合prettier-plugin-vue并在prettier.config.js中显式启用plugins: ['prettier-plugin-vue']
调试局部格式化是否真生效的最快方法
别靠肉眼观察缩进变化——很多 formatter 对小范围选中（如单行、无换行符）会直接跳过。用这个组合验证最准：
- 新建一个
test.js，写入含多行、大括号、空格混杂的函数体 - 选中函数内部全部代码（不包括
function xxx() {和末尾}） - 按
Ctrl+Shift+P→ 输入Format Selection→ 回车 - 观察控制台：
Ctrl+Shift+U打开输出面板 → 切换到Prettier或Python标签页，看是否有rangeFormatting request日志及错误堆栈
真正容易被忽略的点是：局部格式化不是“缩小版全文格式化”，它受限于 formatter 自身解析粒度。比如 Prettier 对 JS 的 range 格式化，要求所选文本必须构成完整语法节点（如一个对象字面量、一个函数参数列表），否则会放弃处理——这不是 bug，是设计使然。
