# CMake 错误：无法创建名为 'Ninja' 的生成器。生成器 'Ninja' 不可用。使用 'cmake --help' 查看可用生成器列表。

- **ID:** `cmake/generator-ninja-not-found`
- **领域:** cmake
- **类别:** config_error
- **验证级别:** ai_generated
- **修复率:** 95%

## 根因

CMake 使用 -GNinja 调用，但 Ninja 未安装或不在 PATH 中，或者 CMake 安装不包含 Ninja 生成器（例如，最小安装）。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.14 | active | — | — |
| 3.20 | active | — | — |
| 3.24 | active | — | — |
| 3.27 | active | — | — |

## 解决方案

1. ```
   安装 Ninja：在 Ubuntu 上运行 'sudo apt-get install ninja-build'；在 macOS 上运行 'brew install ninja'；在 Windows 上从 https://ninja-build.org/ 下载并添加到 PATH。
   ```
2. ```
   使用其他生成器，例如 Unix Makefiles：cmake -G "Unix Makefiles" ..
   ```
3. ```
   如果 Ninja 已安装但不在 PATH 中，请指定完整路径：cmake -G Ninja -DCMAKE_MAKE_PROGRAM=/usr/local/bin/ninja ..
   ```

## 无效尝试

- **Reinstalling CMake without selecting the Ninja generator option** — The Ninja generator is part of CMake's built-in generators; a reinstall without ensuring Ninja is in PATH does not help. (90% 失败率)
- **Setting CMAKE_GENERATOR to Ninja in CMakeLists.txt** — The generator is selected before CMakeLists.txt is parsed, so this setting has no effect; the error occurs at the configuration stage. (95% 失败率)
- **Using -G "Ninja Multi-Config" as a substitute** — If Ninja is not installed, the multi-config generator also fails because it requires the same underlying build tool. (85% 失败率)