ctrl+k ctrl+f 是 vscode 唯一稳定触发选区格式化的快捷键，其生效前提为：选区存在、语言模式正确识别、格式化器注册了 formatrange 协议；失效主因是语言模式错误、插件未启用或不支持范围格式化。
Ctrl+K Ctrl+F 是选区格式化的直连通道
这不是“备选方案”，而是 VSCode 唯一稳定触发 editor.action.formatSelection 的快捷键。它不依赖语言模式是否“正确识别”，只要选区存在、有格式化器注册了 formatRange 协议，就会执行范围格式化。
常见误操作：
- 按完
Ctrl+K后松手太久，再按Ctrl+F就失效——必须在Ctrl+K松开后立刻按Ctrl+F - 只选了一个符号（比如
{或;），Prettier/Black 会直接跳过，因为无法解析出完整语法单元 - 选区跨语言块（如 Markdown 中的
```js代码段），但右下角语言仍是Markdown，此时无格式化器加载
Shift+Alt+F 按了没反应？它根本不是为选区设计的
Shift+Alt+F 绑定的是 editor.action.formatDocument，VSCode 不会自动降级为格式化选区。所谓“选中后按它就只格式化选区”，只是某些语言插件（如 Prettier）在检测到选区且支持 formatRange 时做的额外适配——但这不是标准行为，也不可靠。
失效时优先排查：
- 右下角语言标识是不是
Plain Text或Markdown？手动点击切换成对应语言（如JavaScript）再试 - 打开命令面板（
Ctrl+Shift+P），输入Format Selection—— 如果不出现，说明当前语言没注册范围格式化能力 - 已装插件但未设为默认：比如 JS 文件里
editor.defaultFormatter是空的，或设成了dbaeumer.vscode-eslint但没开启eslint.format.enable
选什么才能被真正格式化？语法边界比视觉选择更重要
VSCode 把选区交给语言服务器做 AST 解析，不是按你鼠标拖的像素范围来处理。选得不准，结果就不可控。
实操建议：
- JS/TS + Prettier：选中整个函数体（包括
function关键字到结尾}），或一个对象字面量的{...}区域 - Python + Black：优先用缩进对齐选中（比如光标放在某行开头，
Shift+↓选中整块逻辑），避免只选中间几行 - Vue/React 单文件组件：
<script></script>块内必须确保语言模式是JavaScript或TypeScript，否则 Volar 或 TypeScript 插件不会接管格式化
为什么有时 Ctrl+K Ctrl+F 也无效？问题一定在语言层
这个快捷键本身没有兼容性问题，失效=当前上下文不满足格式化前提。核心卡点永远是三件事：语言模式、格式化器插件、formatRange 支持。
快速验证步骤：
- 确认文件后缀是否被正确映射：比如
.vue文件可能被files.associations错误映射为html，导致<script></script>块走不了 TS formatter - 检查插件是否启用：Python 用户装了
ms-python.python，但没在设置里启用black或autopep8格式化支持 - 某些老插件（如早期版本的 Python 扩展）只实现
formatDocument，不提供formatRange—— 这类插件在命令面板里搜不到Format Selection
最常被忽略的是：你以为选了代码，其实 VSCode 根本没把它当“可格式化内容”看待——语言模式不对，后面所有快捷键都是摆设。
