VSCode自动保存卡顿主因是editor.formatOnSave同步等待格式化工具响应，需验证CLI是否可用、指定唯一defaultFormatter、改用modifications模式并调高formatOnSaveTimeout。
自动保存卡顿不是 VSCode 本身慢，而是 editor.formatOnSave 同步等待格式化工具响应，一旦 CLI 路径错、插件冲突或超时太短，保存就卡在“正在保存……”状态。
为什么 formatOnSave 一开就卡？
VSCode 保存时默认同步调用格式化器（如 Prettier、ESLint），不是写完文件就结束，而是等它返回结果才解锁界面。常见卡点包括：
-
prettier没装在项目本地（只装了全局），npx prettier --write报Cannot find module 'prettier' - 同时启用
esbenp.prettier-vscode和dbaeumer.vscode-eslint，且都设为默认格式化器，触发串行执行 -
eslint.format.enable为true，导致 ESLint 插件也抢着格式化，和 Prettier 打架 -
formatOnSaveTimeout设得太低（如750），小文件都可能被截断
怎么验证格式化工具是否真能跑通？
别信插件界面上的勾选框——终端才是真相。在项目根目录执行：
npx prettier --write src/index.ts --loglevel warn
如果报错找不到模块，VSCode 必然卡住。同理验证 ESLint：
npx eslint src/index.ts --fix-dry-run
确认它们能正常运行后，再回 VSCode 调整设置。关键动作：
- 在
.vscode/settings.json中指定唯一默认格式化器："editor.defaultFormatter": "esbenp.prettier-vscode" - 关掉 ESLint 的自动格式化：
"eslint.format.enable": false - 确保项目本地安装：
npm install --save-dev prettier eslint - 禁用全局查找：
"prettier.resolveGlobalModules": false
autoSave 模式选哪个才不丢不闪？
files.autoSave 不是越“勤快”越好，错误模式反而放大风险：
-
afterDelay：延迟保存最危险——你敲两行停顿 1.2 秒，它立刻落盘，可能把冲突标记存进去；狂敲 5 秒又完全不保存，断电即丢失 -
onFocusChange：切出当前文件（比如点到终端）时保存——适合单文件专注编辑，防丢且不干扰节奏 -
onWindowChange：整个窗口失焦（Alt+Tab 切浏览器）时保存——适合多窗口并行但不想频繁写盘 - 绝对别设
"files.autoSaveDelay": 10000：等于主动留 10 秒空白期，崩溃即丢失
务必检查项目级 .vscode/settings.json 是否写了 "files.autoSave": "off"——它优先级高于用户设置，容易被忽略。
如何让保存不抖、不跳光标、不重置折叠？
光标跳到开头、已展开函数突然收起，说明格式化器在重写整文件，而非只处理改动。VSCode 1.84+ 提供更精细控制：
- 改用
"editor.formatOnSaveMode": "modifications"：只格式化你改过的行，大幅降低开销 - 调高超时值：
"editor.formatOnSaveTimeout": 2500（别低于 1500，否则小文件也容易被截断） - 配合
.prettierignore放在项目根目录，内容必须含dist/、node_modules/等，且在设置中显式声明："prettier.ignorePath": ".prettierignore"
真正卡顿的根源往往不在“要不要格式化”，而在于“谁在什么时候、以什么范围、用什么路径去格式化”。每个环节漏配，都可能让自动保存从便利变成阻塞点。
