CMake重新运行报错：build.ninja清单100次尝试后仍处于脏状态

报错信息：

[0/1] Re-running CMake...
-- Configuring done
-- Generating done
-- Build files have been written to: path_of_the_program/cmake-build-debug
ninja: error: manifest 'build.ninja' still dirty after 100 tries

可能的原因及对应解决方法 #

1. Ninja与CMake版本不兼容 #

CMake 3.24对Ninja的版本要求可能高于1.10.2，旧版本Ninja在处理CMake生成的构建脚本时容易出现同步逻辑问题。

• 解决方法：升级Ninja到1.11.0及以上稳定版本，替换当前环境中的Ninja可执行文件，执行ninja --version确认版本后重新构建。

2. Windows文件锁定/权限问题 #

Windows后台进程（如实时杀毒软件、IDE后台服务、文件资源管理器）可能锁定了build.ninja文件，导致Ninja无法更新文件内容。

• 解决方法：
  • 关闭所有访问构建目录的程序（包括当前使用的IDE）；
  • 临时禁用杀毒软件对构建目录的实时扫描；
  • 以管理员权限打开命令行，重新执行CMake和Ninja构建命令。

3. CMake生成脚本的时间戳或路径异常 #

Windows文件系统的时间戳处理差异，或构建路径包含特殊字符（如空格、中文），可能导致Ninja误判文件状态。

• 解决方法：
  • 运行CMake时明确指定构建类型：添加-DCMAKE_BUILD_TYPE=Debug参数；
  • 使用绝对路径创建构建目录，避免路径包含特殊字符；
  • 添加CMake参数-DCMAKE_NINJA_FORCE_RESPONSE_FILE=ON，强制Ninja使用响应文件处理构建指令。

4. 环境变量冲突 #

系统PATH中可能存在多个版本的Ninja或冲突工具，导致CMake调用的不是预期版本的Ninja。

• 解决方法：在命令行执行ninja --version确认当前使用的版本，将新版本Ninja的路径移至PATH环境变量最前端，确保优先调用正确版本。

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