VSCode保存时自动格式化需同时设置默认格式化程序和开启formatOnSave：先为各语言指定defaultFormatter（如JavaScript用esbenp.prettier-vscode），再启用"editor.formatOnSave": true，缺一不可。
VSCode 保存时自动格式化，关键在于两件事：指定某个语言的默认格式化程序，以及开启保存时触发格式化的开关。缺一不可，否则即使装了 Prettier、ESLint 或 Black，也完全不会生效。
设置某个语言的默认格式化程序
VSCode 不会自动猜你用哪个格式化工具——哪怕你只装了 Prettier，它也不会默认选它。必须显式告诉 VSCode：JavaScript 文件用 esbenp.prettier-vscode，Python 文件用 ms-python.black-formatter 等。
操作方式有两种：
- 右键编辑器空白处 → “Format Document With…”** → 选中对应格式化器 → 点击 **“Configure Default Formatter…”** → 选择该扩展（如
esbenp.prettier-vscode） - 或直接修改工作区/用户设置：
"[javascript]": {"editor.defaultFormatter": "esbenp.prettier-vscode"}
常见语言对应推荐格式化器 ID：
"[typescript]": {"editor.defaultFormatter": "esbenp.prettier-vscode"}-
"[python]": {"editor.defaultFormatter": "ms-python.black-formatter"}（需已安装ms-python.black-formatter扩展） "[html]": {"editor.defaultFormatter": "esbenp.prettier-vscode"}"[json]": {"editor.defaultFormatter": "esbenp.prettier-vscode"}
开启保存时自动格式化
仅设默认格式化器还不够，VSCode 默认是关闭“保存即格式化”的。必须手动打开这个开关，否则按 Ctrl+S 就只是保存，不触发任何格式动作。
在设置中搜索 format on save，勾选 Editor: Format On Save。也可以写进 settings.json：
"editor.formatOnSave": true
注意：如果同时启用了 editor.formatOnType 或 editor.formatOnPaste，它们是独立开关，互不影响。
常见失效原因和排查点
明明配了却没反应？大概率卡在这几个地方：
- 文件没有正确识别语言模式（右下角显示的是
Plain Text而非JavaScript）→ 点击右下角语言名，手动选择正确语言 - 工作区设置了
"editor.formatOnSave": false，覆盖了全局设置 → 检查.vscode/settings.json是否有冲突配置 - 格式化器扩展未启用，或版本过旧（比如老版
Prettier扩展不支持 VSCode 1.8+ 的新 API）→ 卸载重装esbenp.prettier-vscode - 项目根目录存在
.prettierrc或pyproject.toml，但配置语法错误 → 格式化器加载失败，VSCode 会静默跳过（可在命令面板运行Developer: Toggle Developer Tools查看控制台报错）
多格式化器共存时的优先级
一个项目里可能同时装了 ESLint 和 Prettier，但 VSCode 只允许为每种语言指定一个 defaultFormatter。想让 ESLint 做代码检查 + Prettier 做格式化，就得用 dbaeumer.vscode-eslint 的 eslint.format.enable 配合 editor.defaultFormatter 指向 esbenp.prettier-vscode，再靠 .eslintrc 里的 prettier 插件对齐规则——不是简单装两个扩展就能自动协作的。
真正起作用的永远是 editor.defaultFormatter 指定的那个扩展，其他格式化器除非被它显式调用（如 Prettier 调用 ESLint 的 eslint-config-prettier），否则不会参与保存时的格式流程。
