VSCode files.autoSave 失效最常见原因是工作区设置覆盖用户设置，需依次检查用户级和工作区 settings.json 中的 "files.autoSave" 值是否正确且拼写无误；保存卡顿多因格式化或校验插件拖慢，可调大 editor.formatOnSaveTimeout 或禁用扩展验证；文件未落盘常由云同步或 WSL 路径导致，建议启用 files.useExperimentalFileWatcher；Git 状态不更新则多因文件监视器失效，可通过 files.watcherExclude 优化或重启监视器解决。

VSCode 的 files.autoSave 设置没起作用

自动保存失效，最常见原因是设置被覆盖或冲突。VSCode 支持工作区（.vscode/settings.json）和用户级（settings.json）两层配置，工作区设置优先级更高——如果项目里有 .vscode/settings.json，它可能把 files.autoSave 设成了 "off" 或根本没写，导致你改了全局设置也不生效。

检查顺序建议：

• 先打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），运行 Preferences: Open Settings (JSON)，确认用户级 JSON 中存在且值正确，例如：

  "files.autoSave": "afterDelay",

• 再检查当前文件夹下是否存在 .vscode/settings.json，若有，打开它，确认里面没有 "files.autoSave": "off" 这类覆盖项
• 注意拼写：是 autoSave，不是 autosave 或 auto_save；值必须是字符串："off"、"afterDelay"、"onFocusChange"、"onWindowChange"

保存变慢，尤其是 TypeScript/JS 文件

VSCode 保存时若触发了 ESLint、Prettier、TypeScript 语言服务的保存时格式化或校验，会明显卡顿。这不是 VSCode 自身保存逻辑慢，而是“保存后钩子”拖慢了感知速度。

排查重点：

• 检查是否启用了 editor.formatOnSave，并在 editor.formatOnSaveTimeout 超时前未完成格式化（默认 750ms）
• 查看 eslint.validate 是否对保存事件监听过多（旧版插件可能在每次保存时全量校验）
• 禁用所有扩展后测试：用 Ctrl+Shift+P → Developer: Reload Window With Extensions Disabled，再试保存是否恢复流畅

典型修复配置示例（放入 settings.json）：

"editor.formatOnSave": true,
"editor.formatOnSaveTimeout": 1200,
"eslint.run": "onType"

文件实际没写入磁盘，但 VSCode 显示已保存

这是 Windows 下常见现象：VSCode 默认使用内存映射（files.useExperimentalFileWatcher 关闭时更明显）+ 缓存写入策略，尤其配合 OneDrive、Dropbox、WSL 挂载路径时，系统级文件通知延迟或权限限制会导致 VSCode 认为“保存成功”，而文件内容实际未落盘或同步失败。

验证与应对方式：

• 用记事本或 cat 命令直接读取该文件，确认内容是否更新
• 临时关闭云同步客户端（如 OneDrive 暂停同步），再试保存
• 在 WSL 场景下，避免将项目放在 /mnt/c/... 路径，改用 /home/xxx/ 原生 Linux 文件系统
• 强制刷新文件监视器：设置中启用 files.useExperimentalFileWatcher（值设为 true）

保存后 Git 状态不更新（比如修改未显示为 modified）

这通常不是保存问题，而是 VSCode 的文件监视器未捕获变更事件，Git CLI 却能识别——本质是 VSCode 和 Git 使用了不同机制监听文件变化。VSCode 默认依赖 inotify（Linux）、kqueue（macOS）或 FindFirstChangeNotification（Windows），而这些在某些环境（如 Docker 容器内、远程 SSH 目录、网络共享盘）不可靠。

可尝试的硬性补救：

• 在设置中添加：

  "files.watcherExclude": {
    "**/.git/objects/**": true,
    "**/.git/subtree-cache/**": true,
    "**/node_modules/**": true,
    "**/dist/**": true
  }

  减少 watcher 负担
• 重启 VSCode 的文件监视器：命令面板运行 Developer: Restart Language Server（对部分语言有效），或更彻底地执行 Developer: Toggle Developer Tools → Console 输入 location.reload()
• 终极手段：关闭 git.autoclean 并手动运行 git status 验证真实状态，别完全依赖 VSCode 的源码管理视图

文件监视本身是跨平台的脆弱环节，尤其在混合开发环境里，它不像保存动作那样原子可控——这点容易被忽略，但恰恰是多数“保存看似成功却失联”的根源。