根本原因是editor.formatOnSave开启后同步等待格式化工具响应，而非files.autoSaveDelay值本身；常见阻塞点包括Prettier未安装、路径错误、多插件争抢defaultFormatter，应验证CLI是否可用并改用modificationsIfAvailable模式。
为什么改了files.autoSaveDelay还是卡
根本原因不是延迟值本身，而是editor.formatOnSave开启后同步等待格式化工具响应。VSCode 保存动作本身极快，但一旦启用格式化，就会卡在“正在保存……获取格式化结果”——此时它在等 Prettier、ESLint 或 Black 返回结果。常见阻塞点包括：npx prettier找不到模块、eslint配置路径错误、多个格式化插件争抢editor.defaultFormatter、或 CLI 工具未安装在项目devDependencies里。验证方法：终端进项目根目录，运行npx prettier --write src/index.ts --loglevel warn，报Cannot find module 'prettier'就必然卡住。
files.autoSave选哪个模式才真不卡
三个选项行为差异极大，选错反而放大卡顿：
-
"afterDelay"：停手即倒计时，继续敲字就重置；设太小（如300）会导致打字中途频繁触发保存+格式化，体验割裂；建议调至1500～2500（远程开发）或1000（本地），低于800可能被四舍五入为0，退化成失焦即存 -
"onFocusChange"：切出当前文件（比如点到终端、另一个标签页）时保存——适合单文件专注编辑，防丢且不干扰节奏，但不会保存其他脏文件，容易漏改 -
"onWindowChange"：整个 VSCode 窗口失焦（Alt+Tab 切浏览器）时批量保存所有脏文件，最稳；注意：若开多个 VSCode 窗口，只关其中一个不会触发保存
绝对别用"off"配手动Ctrl+S——格式化链路仍在，且人为漏按风险高；也别设"files.autoSaveDelay": 10000，等于主动留 10 秒空白期，崩溃即丢失。
怎么让保存不触发格式化卡顿又不丢功能
核心是解耦“落盘”和“格式化”，而不是关掉一切：
- 关掉
editor.formatOnSave，但保留editor.formatOnSaveMode为"file"（默认值），再绑定快捷键Shift+Alt+F手动格式化——既避免自动保存时阻塞，又能按需清理 - 若必须自动格式化，改用
"modificationsIfAvailable"模式（VSCode 1.84+），它只在格式化器支持增量处理时才生效，否则静默跳过，不阻塞保存 - 调高
editor.formatOnSaveTimeout到3000（毫秒），避免小文件因超时被截断 - 检查
.vscode/settings.json是否覆盖了全局设置——它优先级最高，哪怕你全局关了formatOnSave，这里写true就仍会触发
真正容易被忽略的配置冲突点
不是数值没设对，而是设置根本没生效：
-
files.autoSave必须是字符串"afterDelay"，写成true、"true"或布尔值都会被忽略 -
files.autoSaveDelay必须是整数（如1000），写成"1000"或1000.0会被静默跳过 - 编辑的是
Untitled-1、只读文件、或 WSL/SSH 路径权限不足时，保存动作根本不会执行，看起来像“没反应” - 语言专属配置优先级高于全局，例如想只对
.js生效，得在[javascript]语言设置里填{"files.autoSave":"onFocusChange"}，不能只写全局files.autoSave
最隐蔽的坑是：editor.formatOnSave一开，保存流程就变成“输入 → 停顿 → 触发格式化 → 写回”，中间任一环节失败（如 Prettier 缺配置、ESLint 修复出错），VSCode 就静默取消保存，连错误提示都不给——你以为是自动保存失效，其实是格式化链路崩了。
