VS Code保存C++文档数秒延迟问题排查及解决方法

保存过程卡顿的定位方法 #

• 查看扩展运行耗时：按F1调出命令面板，执行Developer: Show Running Extensions，保存触发卡顿时可以直接看到所有扩展的实时CPU占用、事件响应耗时，优先排查C/C++相关扩展的阻塞情况。
• 查看保存事件日志：按F1执行Developer: Toggle Developer Tools，切换到Console面板，所有挂载了保存监听事件（onWillSaveTextDocument）的扩展执行耗时都会在这里打印，耗时超过阈值的调用会直接标红，能精准定位卡顿的具体环节。
• 系统级进程排查：卡顿时在终端运行htop（没有的话用top），观察是cpptools、clang-format还是clang-tidy进程CPU占用飙高，直接对应到卡顿源头。

对应现有配置的修复方案 #

从贴出的配置来看，几个高概率触发偶发卡顿的配置项调整方式如下：

• 禁用保存时自动运行的clang-tidy全量检查：当前配置开启了"C_Cpp.codeAnalysis.clangTidy.enabled": true，微软C/C++扩展默认会在保存时触发全文件静态检查，头文件依赖复杂、文件行数较多时会占满CPU核心，直接阻塞保存流程。先添加以下配置关闭自动检查，验证卡顿是否消失：

"C_Cpp.codeAnalysis.clangTidy.enabled": false,
"C_Cpp.codeAnalysis.runAutomatically": false

如果关闭后卡顿消失，又需要保留静态检查能力，建议替换为clangd扩展提供检查能力，不会阻塞保存流程。

• 关闭全局include自动排序：当前配置的"C_Cpp.clang_format_sortIncludes": true会在格式化时遍历所有项目include路径匹配头文件、重排include顺序，项目路径复杂时容易触发IO阻塞。先将该选项设为false测试，确实需要排序include的话，在项目级.clang-format文件中配置规则即可，不要全局开启。
• 排查扩展冲突：终端执行code --disable-extensions启动纯净版VS Code，只启用C/C++扩展测试保存功能，如果不再卡顿，逐个启用其他扩展定位冲突项，常见的冲突项包括自动头文件补全、代码片段自动生成类扩展。
• 替换LSP实现：如果以上调整仍有偶发卡顿，直接卸载微软官方C/C扩展，改用clangd扩展提供C/C语言服务。clangd和写Rust时用的rust-analyzer是同架构的LSP实现，索引、格式化、检查逻辑都不会阻塞编辑器主线程，流畅度和Rust开发体验一致。

验证方式 #

调整配置后打开千行以上的C++源文件，连续触发保存操作10次以上，没有出现数秒的等待转圈即为修复完成。

内容的提问来源于stack exchange，提问作者Normand Espinoza