自动保存功能失效的VSCode插件排查-VSCode-PHP中文网

禁用所有插件后自动保存恢复正常，说明某插件（如eslint、prettier）通过editor.codeactionsonsave或editor.formatonsave在保存前拦截流程，一旦校验失败即中止保存；需查console错误并逐个启用插件验证。

自动保存功能失效的vscode插件排查

为什么禁用所有插件后自动保存突然正常了

说明某个插件在保存流程中主动拦截或覆盖了默认行为，最常见的是 ESLint、Prettier、EditorConfig 或代码检查类插件。它们不是“关掉自动保存”，而是通过 editor.codeActionsOnSave 或 editor.formatOnSave 注册了保存前钩子，一旦其中某项失败（比如格式化报错、类型检查超时），VS Code 会中止整个保存动作——磁盘没写入，但状态栏可能一闪而过“已保存”，造成“失效”假象。

排查建议：

打开开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools），切换到 Console 标签，保存一个文件，看是否有 Failed to save、codeActionsOnSave 或 formatOnSave 相关错误
临时禁用所有扩展，再逐个启用，每次启用后保存测试；重点盯住 ESLint、Prettier、Beautify、Auto Rename Tag 这几类
若确认是 ESLint 插件导致，检查其 editor.codeActionsOnSave 配置里是否包含不可修复规则（如 no-console），或是否启用了 source.fixAll.eslint 但项目里没装对应版本的 eslint

editor.codeActionsOnSave 和 editor.formatOnSave 同时启用会冲突吗

会，而且非常容易静默失败。两者都注册在同一个保存生命周期（onWillSaveTextDocument），但执行顺序和容错逻辑不同：如果 editor.formatOnSave 指向 Prettier，而 editor.codeActionsOnSave 又启用了 source.fixAll.eslint，VS Code 会先尝试运行 ESLint 修复，失败则直接终止后续所有保存动作——Prettier 根本没机会执行。

更隐蔽的问题是：即使两者都成功，也可能因两次写入导致光标跳动、部分代码被重排，尤其在大文件或网络文件系统（如 WSL/SSH）上更明显。

推荐做法：

只保留一个主力：用 Prettier 负责格式（缩进、引号、空行），用 ESLint 负责逻辑（未定义变量、重复键等），不要让它们都抢“保存时格式化”这个位置
若必须共存，确保 ESLint 的 codeActionsOnSave 只启用可修复规则，并在 .eslintrc.js 中加入 prettier/prettier: "error"，再用 eslint-config-prettier 关闭所有与 Prettier 冲突的规则
避免同时设 "editor.formatOnSave": true 和 "editor.codeActionsOnSave": { "source.fixAll.eslint": true } —— 选其一即可

插件没报错，但自动保存就是不触发，怎么定位

这时候问题大概率不在插件本身，而在 VS Code 的触发前提没满足。自动保存不是“有修改就存”，它有一套硬性条件链：文件必须有真实路径 + 处于“已修改”状态（右上角带 ●）+ 不是只读 + 不在 Git 合并冲突标记段内（如 ）+ 不是 Untitled-1 这类无名文件。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

常见漏点：

新建文件还没保存过（路径为空），哪怕写了十行代码，files.autoSave 设成 "onFocusChange" 也完全不生效
右下角语言模式显示为 Plain Text 或 Git Commit Message，VS Code 不会为这些模式启用自动保存逻辑
工作区设置了 "[markdown]": { "files.autoSave": "off" }，结果所有 .md 文件都被跳过，但你只在 JS 文件里测试
文件系统权限不足（比如项目在 Docker volume 或受限目录下），VS Code 写入失败但不弹提示，只在开发者工具 Console 里留一行 EPERM 或 EACCES