VSCode选中代码格式化失效主因是未正确配置语言专属格式化器。需检查右下角语言模式、安装对应扩展、在settings.json中为javascript[vue]等准确languageId设置editor.defaultFormatter，并启用prettier.rangeFormatEnable。
VSCode 选中代码格式化失效的常见原因
直接按 Ctrl+K Ctrl+F（Windows/Linux）或 Option+Shift+F（Mac）没反应，大概率不是快捷键错了，而是当前选区不被格式化器支持。Prettier 默认只响应「整个文档」格式化请求；ESLint 的 eslint.format.enable 也默认不处理选区；Volar 对 Vue 单文件组件中的 <script> 块选中格式化有额外限制。
关键判断点：右下角语言模式是否正确？比如一个 .vue 文件被识别为 Plain Text，那任何格式化操作都会静默跳过。
- 打开命令面板（
Ctrl+Shift+P），输入Format Selection，看选项是否可点击——灰掉说明 VSCode 根本没识别出当前语言 - 检查右下角状态栏语言标签，点击它手动切换为对应 languageId（如
javascript、typescript、vue） - 确认已安装且启用对应语言的格式化扩展（如
esbenp.prettier-vscode、Vue.volar）
必须设置 language-specific defaultFormatter
全局设置 "editor.defaultFormatter" 对选中区域格式化无效。VSCode 要求必须为当前语言显式指定格式化器，否则即使装了 Prettier，选中一段 JS 代码后仍会提示 No formatter available for 'javascript'。
在 settings.json 中添加类似配置（注意方括号和引号）：
{
"[javascript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[typescript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[vue]": {
"editor.defaultFormatter": "Vue.volar"
}
}
- languageId 必须准确，
[js]或[JS]都不生效，只能是小写标准 ID（查法：Ctrl+Shift+P→Change Language Mode，看列表里显示的名称） - 如果项目用 TypeScript，但
.ts文件被识别为javascript，需先修复语言关联，再配 formatter - 不要同时给同一语言设多个 formatter（如既配 Prettier 又配 ESLint），会导致选中格式化行为不可预测
Prettier 需要额外开启选区支持
哪怕配对了 defaultFormatter，Prettier 插件默认仍可能忽略选中区域——它依赖插件自身是否实现 provideDocumentRangeFormattingEdits 接口，而旧版或某些配置下该能力被禁用。
验证与修复方法：
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到 Console 标签页，执行vscode.workspace.getConfiguration('prettier').get('enable')，返回true才表示插件已激活 - 确保未设置
"prettier.requireConfig": true且项目无.prettierrc——否则没有配置文件时 Prettier 会拒绝处理任何内容，包括选区 - 在用户设置中加这一行：
"prettier.rangeFormatEnable": true（部分版本必需，尤其 v12+） - 如果仍不行，换用
prettier-now扩展，它专为选中格式化优化，无需额外配置
避免被 editor.codeActionsOnSave 干扰
有些项目在 .vscode/settings.json 或 package.json 里启用了 editor.codeActionsOnSave，例如：
"editor.codeActionsOnSave": {
"source.fixAll": true,
"source.organizeImports": true
}
这类设置会劫持保存流程，覆盖原本的选中格式化逻辑。更隐蔽的是，它可能让 Ctrl+K Ctrl+F 在某些上下文（如光标在 import 行）触发 fixAll 而非 range formatting。
- 临时排查：关掉所有
codeActionsOnSave相关项，只留"editor.formatOnSave": false - 长期建议：把格式化和代码修复拆开——用
Ctrl+K Ctrl+F专注排版，用Ctrl+Shift+P→Fix All专门修 lint 问题 - 注意：TypeScript 语言服务自带的
source.formatDocument行为不受defaultFormatter控制，若想禁用，得单独设"typescript.preferences.quoteStyle": "auto"等细化项
真正容易被忽略的是：选中格式化依赖格式化器本身的实现粒度。Prettier 对 JSX/TSX 的 range formatting 支持不稳定，Volar 在 <template> 块内选中 HTML 片段时可能退回到内置 HTML formatter——这时候看到的“格式化结果”根本不是你配的那个工具干的。
