vscode不支持按内容差异触发的自动保存，files.autosave仅支持off、afterdelay、onfocuschange、onwindowchange四种模式；ontype非合法值，会被静默忽略；onfocuschange是最贴近“按需保存”的实用选项，适合搭配code-runner等插件。

VSCode 没有“只在代码修改后才保存”这种按内容差异触发的机制——files.autoSave 所有模式都基于**编辑行为或焦点状态**，而非文件内容比对。所谓“按需”，其实是选对触发时机 + 排除干扰项，避免无效保存。

为什么 onType 不是官方支持的选项

网上有些教程提到 onType（每输一个字符就保存），但它**不是 VSCode 当前稳定版的合法值**。设置成 "files.autoSave": "onType" 会被静默忽略，退回到 off；VS Code 官方枚举始终只有四个：off、afterDelay、onFocusChange、onWindowChange。

• 如果你看到插件或旧文档写了 onType，基本是混淆了其他编辑器（如 WebStorm）或已废弃的实验性功能
• 强行写入 settings.json 不会报错，但右下角状态栏不会显示“正在保存中”，也查不到对应日志
• 真要接近“改即存”，唯一可行的是把 files.autoSaveDelay 设为 100（毫秒），配合 afterDelay，但代价是磁盘 I/O 压力陡增，尤其 WSL 或远程开发时明显卡顿

onFocusChange 是最贴近“按需”的实用选择

它不看内容是否变，但行为上天然契合“我改完了、准备干别的事”这个真实意图：只要当前编辑器失去焦点，就立刻落盘。这比“等延迟”更可控，也比“窗口失焦”更精准。

VSCode

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

下载

• 触发场景包括：点击终端面板、切换到另一个打开的标签页（如从 index.ts 切到 utils.ts）、点开资源管理器/搜索/源代码管理侧边栏
• 不触发的场景：微信浮窗盖住 VS Code、系统通知弹出、Spotlight 聚焦搜索——这些只影响 onWindowChange
• 适合搭配 code-runner 类插件：你写完代码，鼠标往终端一挪，文件先保存，再敲 python main.py，确保运行的是最新版本

真正防止“无效保存”的关键配置

自动保存是否“按需”，不取决于模式本身，而取决于它有没有被更高优先级规则覆盖，或被其他逻辑中途拦截。

• 检查 .vscode/settings.json 是否存在 "files.autoSave": "off" —— 工作区设置永远优先于用户设置
• 确认没被语言专属配置屏蔽：比如为 markdown 单独设了 "files.autoSave": "off"，那所有 .md 文件都不会走全局规则
• editor.formatOnSave 开启时，若 Prettier 或 ESLint 格式化失败（缺配置、语法错误、插件未激活），VS Code 会直接放弃本次保存，看起来像“没反应”
• 路径被 files.watcherExclude 或 files.exclude 匹配（如 "**/dist/**"），VS Code 可能跳过监听，也就不会触发保存

远程开发（WSL/SSH）下的特殊表现

在 WSL 或 SSH 连接中，onFocusChange 依然最稳，但 afterDelay 的实际延迟可能比设定值高 300–600ms，尤其当项目路径挂载在 /mnt/c/（Windows NTFS）上时。这不是配置问题，而是文件系统层延迟导致的。

• 建议将项目移到 WSL 原生路径（如 ~/project），能显著降低保存延迟抖动
• 不要依赖 onWindowChange：远程窗口焦点事件在某些桌面环境（如 X11 over SSH）下不可靠，容易漏触发
• 如果用分屏终端写代码，onFocusChange 天然适配——鼠标从编辑器移进终端那一刻就保存，无需额外操作

真正难处理的不是“怎么设”，而是“为什么设了还不生效”：优先级覆盖、插件冲突、路径排除，这三类问题占失效案例的 90% 以上，排查时得一层层往下翻，而不是反复调 files.autoSaveDelay。