现象在 VS IDE 中使用CMake生成器、Ninja执行器编译 C 工程时会出现无法增量编译的情况。配置阶段一切正常但进入构建阶段、由 Ninja 执行器调用 MSVC 编译器的过程中虽然能正常编译出可执行程序输出窗口却会打印大量注意: 包含文件: XXX之类的信息一旦出现这种情况增量编译往往会失效修改某个头文件后依赖它的源文件并不会被重新编译而是直接提示原因分析我尝试单独在 VS 命令行环境中进行配置与构建发现并无问题且无论命令行使用 GBK 还是 UTF-8 编码均表现正常。对比可知VS IDE 将输出来源拆分为CMake 配置与构建阶段因此很容易出现编码不一致配置阶段以GBK写入的数据在Ninja执行器读取或编译器编译过程中被按UTF-8解读。中文字符在不同编码方式下解析结果不同进而引发增量编译失效。解决办法一强制编译器诊断信息使用英文将编译器诊断/提示信息的语言环境强制设为英文编码问题即可直接绕开。原来的CMakeSettings.json为{configurations:[{name:x64-Debug,generator:Ninja,configurationType:Debug,inheritEnvironments:[msvc_x64_x64],buildRoot:${projectDir}\\out\\build\\${name},installRoot:${projectDir}\\out\\install\\${name},cmakeCommandArgs:,buildCommandArgs:,ctestCommandArgs:]}]}在末尾追加语言环境配置将诊断信息设为英文{configurations:[{name:x64-Debug,generator:Ninja,configurationType:Debug,inheritEnvironments:[msvc_x64_x64],buildRoot:${projectDir}\\out\\build\\${name},installRoot:${projectDir}\\out\\install\\${name},cmakeCommandArgs:,buildCommandArgs:,ctestCommandArgs:,environments:[{VSLANG:1033}]}]}设置完成后先清除之前的缓存再重新配置、生成并执行编译可以看到注意: 包含文件: XXX之类的提示不再出现编译输出变得干净增量编译也恢复正常。解决办法二改在命令行窗口中执行配置与构建避免 VS IDE 配置与构建阶段编码差异直接在命令行窗口中执行相关操作示例如下# -S . 指定源码根目录为当前目录# -B build 指定构建输出目录为 build不存在会自动创建# -G Ninja 生成 Ninja 构建脚本cmake-S.-Bbuild-GNinja# cmake --build build 执行编译读取 build 目录下的 Ninja 工程进行构建cmake--buildbuild
