vscode保存卡在“saving…”是因formatonsave同步等待格式化器响应超时或失败，常见于prettier/eslint路径错误、未安装、多插件冲突或cli不可用；应验证npx prettier能否正常运行、指定唯一defaultformatter、改用modificationsifavailable模式并调高formatonsavetimeout。
VSCode 保存卡在 Saving... 状态，不是磁盘写不进去，而是编辑器在等某个扩展的响应——大概率是格式化或代码操作钩子没返回，被默认 750ms 超时机制拦住了。
为什么 editor.formatOnSave 一开就卡住
VSCode 的 editor.formatOnSave 是同步阻塞式调用：它会挨个触发已注册的格式化器（比如 Prettier、ESLint、Black），直到其中一个成功返回，或全部超时。一旦某个格式化器 CLI 找不到、路径错、版本不兼容，或插件本身没激活，就会卡在“正在获取格式化结果”。
- 终端进项目根目录运行
npx prettier --write src/index.ts --loglevel warn，报Cannot find module 'prettier'→ VSCode 必然卡住 - 同时启用 Prettier 和 ESLint 插件，但没设
editor.defaultFormatter→ VSCode 会先调 Prettier，失败后再试 ESLint，双倍等待 -
editor.formatOnSaveTimeout设成750（默认值）但格式化器实际要 900ms → 直接超时，状态栏卡死
如何快速定位是哪个扩展在阻塞保存
别猜，用开发者工具看真实错误：
- 按
Ctrl+Shift+P→ 运行Developer: Toggle Developer Tools，切到Console标签页 - 再执行一次保存，留意是否有
spawn ENOENT（命令找不到）、Promise never resolved或TypeError报错 - 重点盯
Prettier、ESLint、Python、TypeScript扩展名带format/code-action的插件 - 临时禁用所有扩展：
Ctrl+Shift+P→Extensions: Disable All Installed Extensions，再逐个启用验证
绕过卡顿但保留功能的实操配置
不用全关格式化，也能让保存不被拖死：
- 把
editor.formatOnSaveMode改成"modificationsIfAvailable"：格式化器可用时只改改动行，不可用时不阻塞保存 - 把
editor.formatOnSaveTimeout提高到1200，给 CLI 更合理响应窗口 - 清空
editor.codeActionsOnSave值（设为{}），或至少关掉耗时项：{"source.fixAll": false, "source.organizeImports": false} - 确认工作区
.vscode/settings.json没覆盖files.autoSave为"off"—— 它优先级高于用户设置
大文件或远程开发时的特殊处理
本地流畅的项目，放到 WSL2 或 Remote-SSH 后卡住，往往不是配置问题，而是底层 I/O 延迟被放大：
- 远程保存卡顿常见于
await值飙升（iostat -x 1 5可见），说明文件监听器（chokidar）和 NFS/CIFS 卷有事件积压 - 大文件（>50MB）建议关掉
editor.formatOnSave，并设files.maxMemoryForLargeFilesMB为200 - 避免在 OneDrive/钉钉文档/腾讯微云 同步目录中直接编辑 —— 它们会劫持 write 系统调用，VSCode 认为保存成功，其实内容没落盘
- 路径含中文或空格时，Windows 下易出
Unable to write file，临时换到C:\tmp\测试可快速验证
真正难调的不是配置开关，而是格式化器 CLI 是否真能在当前上下文跑通：它依赖的 Node 版本、Python 解释器路径、node_modules 位置、甚至 PATH 环境变量，VSCode 启动方式（桌面图标 vs 终端里敲 code）都会影响。别跳过终端验证这一步。
