根本原因是VSCode未激活CMake配置或插件未找到项目根目录下的CMakeLists.txt；必须打开含该文件的最外层文件夹，确保状态栏显示CMake状态，若提示“No kits found”需运行CMake: Scan for Kits或手动配置cmake.cmakePath。
VSCode 里 CMake Tools 插件不识别 CMakeLists.txt 怎么办
根本原因通常是 CMake 配置未激活，或插件没找到项目根目录下的 CMakeLists.txt。VSCode 不自动扫描子目录，必须手动指定工作区根路径。
- 确保打开的是包含
CMakeLists.txt的**最外层文件夹**（不是其父目录，也不是某个 src 子目录） - 检查状态栏右下角是否有 CMake 构建状态（如 “Ready” 或 “Configure failed”），点击它可触发重新配置
- 如果提示 “No kits found”，说明插件没检测到编译器：打开命令面板（
Ctrl+Shift+P），运行CMake: Scan for Kits，或手动在settings.json中指定："cmake.cmakePath": "/usr/bin/cmake",<br>"cmake.configureEnvironment": {"CC": "/usr/bin/gcc", "CXX": "/usr/bin/g++"} - 避免在
.vscode/settings.json中错误覆盖cmake.buildDirectory路径，尤其不要写成相对路径如./build—— 应使用${workspaceFolder}/build
Qt Creator 导入 CMake 项目后 execute cmake 报错找不到编译器
Qt Creator 的 Kit 配置是独立于系统环境的，即使终端里 gcc --version 正常，Qt Creator 也可能用错路径或漏配。
- 进入
Tools → Options → Kits，确认“Compiler”和“CMake”两个 tab 都已填好：C++ 编译器选g++（不是gcc），CMake 路径指向/usr/bin/cmake或你安装的版本（如/opt/cmake/bin/cmake） - Kit 的 “CMake Configuration” 默认值是空的，但如果你用了交叉编译或自定义工具链，必须在这里加一行：
CMAKE_C_COMPILER:STRING=/path/to/arm-gcc<br>CMAKE_CXX_COMPILER:STRING=/path/to/arm-g++
- 右键项目 → “Execute CMake” 前，先点左下角“Projects”页签，检查“Build directory”是否为干净的空目录；残留的
CMakeCache.txt会锁住旧配置，直接删掉整个 build 目录再试 - 若报错含
Could not find compiler set in environment variable CC，说明 Kit 里没绑定编译器，不是环境变量问题 —— 别去改 shell 的CC，而是回到 Kit 设置里补全
CLion 自动配置失败，add_executable 提示源文件路径不存在
CLion 默认启用“use external build system”，但它对相对路径解析比命令行更严格，尤其当 CMakeLists.txt 里用了 file(GLOB ...) 或变量拼接时。
- 禁用 “Reload project after changes in CMakeLists.txt”（Settings → Build → CMake），改用手动重载：右键
CMakeLists.txt→ “Reload CMake Project” -
add_executable(myapp src/main.cpp)中的src/main.cpp必须相对于CMakeLists.txt所在目录 —— CLion 不会帮你把 workspace root 当作基准，哪怕你在 IDE 里展开的是同一级目录 - 如果项目结构是
project/CMakeLists.txt+project/src/main.cpp，就别写成../src/main.cpp；CLion 不支持上溯父目录的写法，会静默忽略文件 - 遇到
Cannot find source file且路径明明存在，先关掉 CLion，删掉.idea/caches/和.idea/workspace.xml，再重启 —— 这是它的缓存 bug 高发区
DevEco Studio 引用第三方 CMake 库时 find_package 总是失败
DevEco Studio 的 CMake 运行环境隔离性很强，find_package 不会自动继承系统 PKG_CONFIG_PATH 或全局 CMAKE_PREFIX_PATH，必须显式注入。
立即学习“C++免费学习笔记（深入）”；
-
find_package(OpenSSL REQUIRED)失败，不是 OpenSSL 没装，而是 DevEco 不知道去哪找 —— 在顶层CMakeLists.txt开头加：set(CMAKE_FIND_ROOT_PATH "/path/to/openssl/install")<br>set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)<br>set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
- 第三方库若没提供
*Config.cmake文件（比如只给了libssl.a和include/openssl/），就不能用find_package，得改用add_subdirectory或手动target_include_directories+target_link_libraries - 注意 DevEco 的 NDK 路径是硬编码的，如果第三方库依赖特定 ABI（如
arm64-v8a），必须确保它的install目录下有对应子目录，否则CMAKE_FIND_ROOT_PATH会跳过整个路径
CMake 在不同 IDE 中的行为差异，本质是它们各自封装了不同的 CMake 调用方式和环境隔离策略。最易被忽略的是：IDE 不会复用你的 shell 环境变量，也不共享 CMake 缓存 —— 每个 IDE 都要单独配 Kit、单独清 build、单独验证路径基准。
