绝大多数CMake路径错误源于环境变量、IDE未继承PATH或构建工具缺失，而非CMake本身故障；需先验证cmake --version是否可用，再检查cmake.cmakePath配置（注意Windows双反斜杠或正斜杠）、Ninja/Make是否安装并加入PATH，最后清理CMakeCache.txt和build目录重配。
VS Code 或 CLion 报 CMake 路径错误，绝大多数情况不是 CMake 本身坏了，而是环境、配置或路径解析环节出了偏差。直接定位并修复比重装更高效。
找不到 cmake 可执行文件？先确认安装和 PATH
报错如 "cmake.cmakePath" is not set 或 command 'cmake' not found，本质是编辑器没找到 cmake 命令。
- 终端里运行
cmake --version，能输出版本号说明已安装；否则先装：Windows 从官网下安装包，macOS 用brew install cmake，Linux 用sudo apt install cmake - 如果命令行可用但 IDE 不认，大概率是 IDE 没继承系统 PATH——尤其 Windows 上有中文路径或乱码路径时，VS Code 会直接崩溃解析（不是报错，是静默失败）
- 临时验证：在 VS Code 终端里手动运行
cmake --version，失败则说明 PATH 没传进去；成功则问题出在插件配置上
cmake.cmakePath 配置写错路径？注意平台差异和转义
手动填 cmake.cmakePath 是最稳妥的绕过 PATH 依赖的方式，但路径字符串极易出错。
- Windows 路径必须用双反斜杠或正斜杠：
"C:\Program Files\CMake\bin\cmake.exe"或"C:/Program Files/CMake/bin/cmake.exe"；单反斜杠如"C:Program FilesCMakeincmake.exe"会被解释成转义序列（P、C非法） - macOS/Linux 注意 Homebrew 安装路径可能随芯片变化：
/opt/homebrew/bin/cmake（Apple Silicon） vs/usr/local/bin/cmake（Intel） - CLion 用户别只改全局设置，检查当前工作区的
.vscode/settings.json或.idea/misc.xml，不同项目可能覆盖了路径
CMAKE_MAKE_PROGRAM 找不到？其实是 Ninja/Make 没配好
CMake Error: CMAKE_MAKE_PROGRAM is not set 这类报错常被误认为 CMake 问题，实际是它找不到底层构建工具。
- VS Code 的 CMake Tools 默认尝试找
ninja，没装就 fallback 到make；但 Windows 默认既没ninja也没make，必须手动装（推荐choco install ninja或下载 Ninja 二进制放 PATH） - CLion 在 Windows 下默认用 MSBuild，但如果项目显式指定
-G Ninja，就必须确保ninja在 PATH 里，且版本兼容（Ninja 1.10+ 对 CMake 3.20+ 更友好） - 不要依赖 CMake 自动探测——在
cmake.configureArgs里硬编码生成器更稳，例如："-G", "Ninja"或"-G", "Visual Studio 17 2022"
Qt6_DIR、NDK 路径不生效？变量名和层级必须严格匹配
这类“找不到包”的错误，90% 是路径指向了错误的目录层级，而非真没装。
-
Qt6_DIR必须精确到lib/cmake/Qt6/目录，例如/opt/qt/6.7.2/gcc_64/lib/cmake/Qt6/；填/opt/qt/6.7.2就会失败，因为里面没有Qt6Config.cmake - Android NDK 路径在
local.properties中写android.ndkpath，但 CMake CLI 可能读ANDROID_NDK_ROOT环境变量——两者不一致时，AGP 8.0+ 优先用前者，CMake 却用后者，结果就是“NDK found but version incompatible” - 所有自定义路径变量（如
OpenCV_DIR）都需用绝对路径，且不能含空格或中文；路径末尾不加斜杠，CMake 内部会自动处理
路径配置真正难的不是写对一行字符串，而是在多层环境（系统 PATH、IDE 启动上下文、CMake 缓存、Shell 子进程）中保持一致性。每次改完路径，务必删掉 CMakeCache.txt 和 build/ 目录再重新 configure，否则旧缓存会掩盖新配置。
