vscode自动格式化不生效，需同时启用files.autosave和editor.formatonsave，并确保对应语言已配置defaultformatter及正确安装启用格式化插件。
VSCode 安装完默认既不自动保存，也不自动格式化——这两个功能必须手动配对启用，否则 Ctrl+S 就只是存盘，不会动一行代码。
editor.formatOnSave 开了但没反应？检查这三件事
只在设置里勾选“Format On Save”远远不够。VSCode 需要同时知道：该不该格式化、用谁来格式化、当前文件是否支持这个“谁”。
- 确认
editor.formatOnSave设为true（全局或语言专属） - 确认对应语言已安装并启用了格式化插件，比如
esbenp.prettier-vscode（JS/TS）、ms-python.black-formatter（Python）、junstyle.php-cs-fixer（PHP） - 确认该语言有明确的
defaultFormatter配置，例如："[javascript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" }—— 不能只写全局"editor.defaultFormatter"，否则 Python 或 Go 文件会报错或静默失败 - 右下角状态栏看语言模式（如 “JavaScript”），再点它 → “Configure Default Formatter”，可交互式补全配置
- 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），保存时看 Console 是否有No formatter registered for 'typescript'这类报错
files.autoSave 必须开启，否则 formatOnSave 根本不触发
files.autoSave 控制“要不要把编辑内容写进磁盘”，editor.formatOnSave 控制“写之前要不要格式化”。前者关了，后者就永远没机会执行。
-
files.autoSave默认是off，必须显式改成afterDelay（推荐）、onFocusChange或onWindowChange - 设为
afterDelay时，务必同步配files.autoSaveDelay（单位毫秒），建议1000（1 秒），避免频繁小改动反复写盘 - 注意工作区设置优先级更高：如果项目根目录存在
.vscode/settings.json，它会覆盖你的用户级设置；按Ctrl+Shift+P→Preferences: Open Workspace Settings (JSON)可确认当前生效位置 - 远程开发（如 WSL、Dev Container）中，
files.autoSave可能被代理拦截，需查阅对应扩展文档是否声明限制
多格式化器共存时，别让 Prettier 和 ESLint 打架
JS/TS 项目里同时装了 esbenp.prettier-vscode 和 dbaeumer.vscode-eslint，保存时缩进跳、引号切、光标乱跑——这不是 bug，是规则冲突。
- 停用 ESLint 的格式化能力：
"eslint.format.enable": false，保留其 lint 提示功能 - 改用
editor.codeActionsOnSave让 ESLint 只做修复："source.fixAll.eslint": true - 显式指定 Prettier 路径，避免版本混乱：
"prettier.prettierPath": "./node_modules/prettier" - 生成文件（如
dist/、__pycache__/）可单独禁用："[javascript]": { "editor.formatOnSave": false }放进工作区设置
editor.formatOnSaveMode 设成 modifications 很容易翻车
VSCode 1.84+ 加入了 editor.formatOnSaveMode，默认 file 是安全的，但设成 modifications 会引发一系列隐性问题。
-
modifications模式依赖 diff 算法判断“哪些行改了”，当文件 >2MB 或含 Git 冲突标记（）时，diff 可能失败，导致格式化静默跳过 - 多数 formatter（如 Prettier）本身不支持增量格式化，强行启用
modifications会回退到全文件格式化，反而更慢 - 真需要性能优化，优先考虑关闭
editor.formatOnSave，改用手动触发Shift+Alt+F
最常被忽略的是工作区设置覆盖和语言专属配置缺失——你以为配好了，其实 .vscode/settings.json 里一句 "[typescript]": { "editor.formatOnSave": false } 就能让所有 TS 文件彻底失效。
