保存时自动格式化需同时满足三条件：开启editor.formatOnSave、为当前语言指定defaultFormatter、对应扩展已安装启用；否则Ctrl+S无反应，常见于设置覆盖、语言模式错配或扩展未启用。
保存时自动格式化不会默认开启，哪怕你已装好 Prettier、Black 或 ESLint —— 必须同时满足三个条件：开启 editor.formatOnSave、为当前语言指定 editor.defaultFormatter、且对应格式化扩展已安装并启用。
为什么按 Ctrl+S 没反应？先查这三件事
绝大多数“配了没用”问题都卡在这三步上，不是插件没装对，而是 VSCode 根本没启动格式化流程：
-
editor.formatOnSave在 settings.json 里必须是true（默认为false） - 右下角状态栏显示的语言模式（如
Python或TypeScript）必须和你配置的格式化器匹配；若显示None，说明 VSCode 找不到可用 formatter - 项目根目录下的
.vscode/settings.json会覆盖全局设置，里面若写了"editor.formatOnSave": false，整个项目就失效
每种语言都要单独配 editor.defaultFormatter
VSCode 不会跨语言复用 formatter，也不能靠“全局 editor.defaultFormatter”一劳永逸——那样会导致 .py 文件报 No formatter installed for 'python'，或 .json 被 Prettier 错误处理。
- 正确做法是在
settings.json中按语言块配置，例如：
{
"[javascript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[typescript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[python]": {
"editor.defaultFormatter": "ms-python.black-formatter"
}
}
ms-python.python 扩展本身不提供格式化能力，必须装 ms-python.black-formatter，或确保 python.formatting.provider 设为 "black" 或 "autopep8"
"editor.defaultFormatter": "esbenp.prettier-vscode" 这样的全局配置，它会让非 JS/TS 文件也尝试调用 Prettier，直接失败多个格式化器共存时容易静默失败
同时启用 esbenp.prettier-vscode 和 dbaeumer.vscode-eslint，或装了 HookyQR.beautify，VSCode 可能反复调用、光标乱跳，甚至最终跳过格式化。
- 推荐只留一个主力 formatter，其余禁用（比如确定用 Prettier，就停用 Beautify 和 ESLint 的格式化功能）
- ESLint 建议仅用于检查，修复交给
editor.codeActionsOnSave控制，例如："source.fixAll.eslint": true，但需确保eslint.format.enable为true且项目有.eslintrc.js - 按
Ctrl+Shift+P→Format Document With查看当前可用列表，为空说明扩展未启用或不支持该语言
文件类型识别错，再怎么配也没用
VSCode 是根据文件后缀 + 右下角语言模式来决定调用哪个 defaultFormatter 的。如果 .jsx 被识别成 Plain Text，editor.formatOnSave 就直接跳过。
- 点右下角语言标签可手动切换，比如把
Plain Text改成JavaScript React - 检查是否被
files.associations干扰，例如"*.vue": "html"会导致 Vue 文件走 HTML formatter 而非 Prettier - 项目级配置（如
.prettierrc、pyproject.toml）会被对应 formatter 自动读取，优先级高于 VSCode 设置；但它们不影响editor.formatOnSave是否触发
最容易被忽略的是：格式化器扩展必须处于“启用”状态，且与当前文件语言模式严格匹配。VSCode 不会猜测你要用谁，也不会降级 fallback——它要么找到完全匹配的 formatter，要么安静跳过。配完记得重启窗口或重载窗口（Ctrl+Shift+P → Developer: Reload Window），避免缓存干扰。
