VSCode中editor.formatOnSave无效需同时满足三点：files.autoSave非off、editor.formatOnSave为true、对应语言配置了defaultFormatter。
editor.formatOnSave 开了但没反应？先确认三件事
VSCode 默认不格式化、也不自动保存——editor.formatOnSave 单独开启毫无作用。必须同时满足：文件真被保存（files.autoSave ≠ "off"）、格式化开关打开（editor.formatOnSave 为 true）、当前语言有明确指定的格式化器（如 "[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }）。
- 右下角状态栏显示
None→ 当前文件没匹配到任何格式化器，不是插件没装，是配置没对上语言 - 按
Shift+Alt+F能格式化，但Ctrl+S不行 →files.autoSave还是"off"，保存动作根本没触发格式化流程 - 装了
esbenp.prettier-vscode却提示No formatter installed for 'typescript'→"[typescript]"段落缺失或拼写错误（比如写成prettierrc-vscode）
按语言配 editor.defaultFormatter，别写全局
全局设 "editor.defaultFormatter": "esbenp.prettier-vscode" 看似省事，实际会让 .json、.html 甚至 .md 全部走 Prettier，可能破坏语义或报错。正确做法是分语言块声明：
"[javascript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[typescript]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
},
"[python]": {
"editor.defaultFormatter": "ms-python.black-formatter",
"python.formatting.provider": "black"
},
"[html]": {
"editor.defaultFormatter": "esbenp.prettier-vscode"
}
- Python 用户额外注意：
python.formatting.provider必须显式设为"black"或"autopep8"，否则即使editor.defaultFormatter对了也静默失败 - Vue 文件若用 Volar，别混用 Prettier；
"[vue]": { "editor.defaultFormatter": "Vue.volar" }更稳妥 - JSON 文件推荐单独配 Prettier，避免
jsonc被误处理，加一行"[jsonc]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }
files.autoSave 设成 afterDelay 最实用
files.autoSave: "onFocusChange" 容易误触（切 Tab 就保存），"onWindowChange" 太滞后。"afterDelay" 配合 files.autoSaveDelay: 1000（单位毫秒）才是平衡点：改完停顿 1 秒自动存，既防丢又不打断思路。
- 项目根目录有
.vscode/settings.json？它会覆盖你的用户设置，务必检查是否被意外禁用了files.autoSave - WSL 或 Dev Container 环境中，某些远程插件会拦截
files.autoSave，此时需查对应插件文档，不能只改 VSCode 设置 - 临时跳过一次格式化：Windows/Linux 按住
Alt再按Ctrl+S；macOS 是Option+Cmd+S
editor.formatOnSaveMode 设成 file 别乱动
VSCode 1.84+ 默认 editor.formatOnSaveMode: "file" 是安全的。改成 "modifications" 听起来高效，但实际极易出问题：
- 文件 >2MB 时 diff 失败，格式化直接静默跳过，连错误都不报
- Git 冲突标记（
）存在时，diff 算法无法识别改动范围，整个格式化流程中断 - Prettier 本身不支持增量格式化，
modifications模式会退化为全文件格式化，反而更慢
真正卡顿时，优先关掉 editor.formatOnSave，改用快捷键 Shift+Alt+F 手动触发——比硬扛一个不稳定的模式更可控。
