editor.codeActionsOnSave 动作失败会导致保存被静默取消，状态栏误显“已保存”；需通过开发者工具查 Failed to save 报错，排查 Prettier/ESLint/Ruff 等插件配置或超时问题。
editor.codeActionsOnSave 导致保存被静默取消
VS Code 的自动保存流程不是原子操作：它先写入磁盘，再触发 editor.codeActionsOnSave 配置的代码动作（如格式化、类型检查）。如果其中任一动作失败（比如 Prettier 缺配置、ESLint 卡住、Ruff 未安装），整个保存会被中止——但状态栏仍会短暂显示「已保存」，造成“明明设了 files.autoSave 却没落盘”的错觉。
验证方式：打开开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools），在 Console 中搜索 Failed to save 或 codeActionsOnSave 相关报错。常见错误包括 Cannot find module 'prettier' 或 Timeout waiting for eslint server。
- 临时禁用所有扩展后测试自动保存是否恢复；确认问题后，单独排查启用
editor.codeActionsOnSave的插件（如esbenp.prettier-vscode、dbaeumer.vscode-eslint） - 若必须保留格式化，可缩小作用范围：只对特定语言启用，例如
"[typescript]": { "editor.formatOnSave": true }，避免影响 .md 或 .json 等非代码文件 - 禁用格式化但保留其他动作：将
editor.codeActionsOnSave设为{ "source.organizeImports": true }，去掉"source.fixAll"或"source.format"
formatOnSave 和 autoSave 混用时的优先级陷阱
editor.formatOnSave 是独立开关，但它和 files.autoSave 不是并列关系，而是嵌套依赖：只有 files.autoSave 触发了保存动作，editor.formatOnSave 才有机会执行。所以你可能遇到两种典型失效：
-
files.autoSave设为"afterDelay"，但files.autoSaveDelay被设为0或负数 → 自动保存退化为"off"，根本不会走到格式化环节 -
files.autoSave是"onFocusChange"，但你在编辑器内点终端后立刻按 Ctrl+F5 运行 → 终端获得焦点触发保存，但格式化尚未完成，运行的仍是旧内容 - 某些插件（如
formulahendry.code-runner）自带code-runner.saveFileBeforeRun，它绕过files.autoSave直接调用保存，此时editor.formatOnSave是否生效，取决于该插件是否等格式化完成再执行
如何安全禁用格式化插件的拦截
直接关掉 editor.formatOnSave 最快，但更稳妥的做法是分层控制：先确保自动保存本身能跑通，再决定是否加格式化。
- 全局禁用：在用户设置中添加
"editor.formatOnSave": false；注意这不是关闭插件，只是断开“保存”和“格式化”的绑定 - 工作区级禁用：在项目根目录
.vscode/settings.json中写入"editor.formatOnSave": false，不影响其他项目 - 语言专属禁用：例如 Python 项目常因
python.linting.enabled+editor.codeActionsOnSave双重触发而卡住，可设"[python]": { "editor.formatOnSave": false } - 不删插件、只停动作：保留 Prettier/ESLint 插件用于手动格式化（Shift+Alt+F），仅禁用其自动介入，避免破坏团队协作流程
远程开发（WSL / SSH）下特别容易踩的坑
在 WSL 或 Remote-SSH 场景中，插件实际运行在远程机器上，但用户设置可能仍指向本地配置。这意味着你本地改了 editor.formatOnSave，远程端却完全没生效。
- 必须检查远程端的
~/.vscode-server/data/Machine/settings.json（WSL）或~/.vscode-server/data/Machine/settings.json（SSH），而非本地settings.json - 远程端的
files.autoSaveDelay默认值可能被内核缓存拉长，建议设为1200而非1000，避开 SSD 缓存抖动 - 某些远程插件（如
ms-python.python）会在保存前启动语言服务器，若服务器未就绪，codeActionsOnSave会超时失败，表现为“切窗口后没保存”，实则是等待超时被丢弃
