VSCode 自动保存需正确配置 files.autoSave 及关联选项：可选 afterDelay（配 files.autoSaveDelay）、onFocusChange 等模式；支持 JSON 手动设置、按文件类型过滤、工作区隔离及排查扩展冲突。
如果您在使用 VSCode 编辑代码时希望文件在失去焦点或经过一定延迟后自动保存，但当前未生效或行为不符合预期，则可能是由于自动保存设置未正确配置或与其他扩展产生冲突。以下是实现该功能的多种配置方式：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用基础自动保存模式
VSCode 提供内置的 autoSave 设置，可通过修改工作区或用户设置直接启用，无需安装额外插件，适用于大多数日常编辑场景。
1、按下 Cmd + , 打开设置界面。
2、在右上角搜索框中输入 files.autoSave。
3、点击下拉菜单，选择 afterDelay、onFocusChange 或 onWindowChange 中任一选项。
4、若选择 afterDelay，继续搜索 files.autoSaveDelay 并将数值设为 1000（单位毫秒）。
二、通过 settings.json 手动配置
直接编辑 配置文件 可实现更精确的控制，支持按语言、文件夹或工作区差异化设置，避免全局策略干扰特定项目需求。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入并选择 Preferences: Open Settings (JSON)。
3、在大括号内添加如下字段：
“files.autoSave”: “afterDelay”,
“files.autoSaveDelay”: 800
4、保存文件，配置立即生效。
三、基于文件类型禁用自动保存
某些文件（如 Markdown 预览源、临时日志或 Git 合并冲突标记文件）不适合自动保存，可通过 files.autoSaveFilter 设置白名单或黑名单进行精细控制。
1、打开 settings.json 文件。
2、添加以下配置块：
“files.autoSaveFilter”: {“*.md”: “off”, “**/logs/*.log”: “off”}
3、确保该配置位于顶层 JSON 对象内，与其他设置同级。
四、利用工作区设置隔离项目行为
当多个项目对自动保存有不同要求时，可在当前工作区的 .vscode/settings.json 中定义独立配置，优先级高于用户级设置，避免跨项目干扰。
1、在项目根目录下确认存在 .vscode 文件夹。
2、在其中新建或编辑 settings.json 文件。
3、写入仅适用于本项目的配置，例如：
“files.autoSave”: “onFocusChange”
4、关闭并重新打开该工作区，验证设置是否被识别。
五、检查扩展与保存钩子冲突
部分扩展（如 Prettier、ESLint Auto Fix、GitLens）会在保存时触发格式化或提交操作，可能导致保存延迟、重复写入或失败，需排查其 save-related 钩子是否启用。
1、按下 Cmd + Shift + P，输入 Extensions: Show Enabled Extensions。
2、依次点击每个已启用的格式化类扩展，查看其设置页中是否勾选了 Run on Save 或类似选项。
3、对确认冲突的扩展，在其设置中将对应开关设为 false。
4、重启 VSCode 窗口以确保钩子状态重载。
