VSCode保存卡顿主因是editor.formatOnSave启用后同步等待格式化工具响应，而Prettier/ESLint等CLI路径错误、未安装或插件冲突导致阻塞；应验证CLI能否正常运行、指定唯一defaultFormatter、改用modificationsIfAvailable模式并调高formatOnSaveTimeout。
为什么“自动保存 + 格式化”一开就卡顿
VSCode 保存变慢、右下角卡在“正在保存……获取格式化结果”，根本不是编辑器本身写文件慢，而是 editor.formatOnSave 启用后，它会同步等待 Prettier/ESLint/Black 等工具返回结果。一旦某个格式化器没响应、路径错、CLI 版本不兼容，或多个插件争抢默认格式化权，就会阻塞整个保存流程——你敲完回车，光标不动，文件状态栏一直转圈。
- 常见诱因：
prettier没装在项目devDependencies里（只装了全局）；eslint插件未启用但配置了eslint.validate；同时启用了Prettier和ESLint插件却没指定editor.defaultFormatter - 验证方法：终端进项目根目录，运行
npx prettier --write src/index.ts --loglevel warn，如果报Cannot find module 'prettier'，VSCode 必然卡住 - 别信“重装插件”——90% 的问题出在 CLI 工具链是否真能跑通，而不是 VSCode 插件界面有没有勾上
files.autoSave 选哪个模式才不闪不丢
afterDelay 看似省心，实则最危险：你改两行停顿 1.2 秒，它立刻落盘，可能把半截 <<<<<< HEAD 冲突标记存进去；而狂敲 5 秒，它又完全不保存，断电就白干。真正稳的不是“延迟”，是“时机可控”。
-
onFocusChange：切出当前文件（比如点到终端、另一个标签页）时保存——适合单文件专注编辑，防丢且不干扰节奏 -
onWindowChange：整个 VSCode 窗口失焦时保存（Alt+Tab 切浏览器）——适合多窗口并行但不想频繁写盘的人，注意：若开多个 VSCode 窗口，只关其中一个不会触发保存 - 绝对别设
"files.autoSaveDelay": 10000：等于主动留 10 秒空白期，崩溃即丢失 - 务必确认没被工作区覆盖：检查项目下
.vscode/settings.json是否写了"files.autoSave": "off"—— 它优先级高于用户设置
如何让保存不触发光标跳转和折叠重置
保存后代码突然“抖一下”、光标跳到文件开头、已展开的函数折叠又收回去，大概率是格式化器在重写整文件，而非仅处理改动区域。VSCode 1.84+ 引入了更精细的控制开关，不用关掉格式化，也能避免副作用。
- 改用
"editor.formatOnSaveMode": "modificationsIfAvailable"：只格式化你改过的行；如果格式化器不可用（比如没装 prettier），直接跳过，不阻塞保存 - 配合理调超时：
"editor.formatOnSaveTimeout": 2000（别低于 1500，否则小文件也容易被截断） - 禁用“全量校验”：把
eslint.run从onSave改成onType，避免每次保存都扫全项目 - 语言级隔离：在
settings.json里按需配置，例如："[typescript]": { "editor.formatOnSave": false }，JS 文件照常格式化，TS 文件手动 Shift+Alt+F
files.watcherExclude 配错反而更卡
很多人复制粘贴一堆 "**/node_modules/**": true 就以为万事大吉，但 VSCode 文件监视器对路径匹配极敏感。配错一条，不仅无效，还可能让 Electron 主进程反复重试监听失败的路径，CPU 直接飙到 100%。
- 必须用双星号：
"**/node_modules/**"，不能写成"node_modules"或"node_modules/**"—— 前者只匹配根目录，后者漏掉子目录层级 - 别盲目加
"**/**": true：这会让 VSCode 放弃所有文件变更通知，Git 状态不更新、重命名失败、保存后文件树不刷新 - WSL / OneDrive / Dropbox 用户额外注意：
files.useExperimentalFileWatcher在某些挂载路径下反而更慢，可尝试设为false并重启工作区 - 改完必须关闭并重新打开当前工作区——热重载不生效，这是 Electron 的限制，不是 bug
