clion启动时自动扫描gcc、g++、cmake等命令但常失败；需用which cmake && which g++验证，任一无输出则须手动配置toolchains，cmake路径填绝对路径，编译器指向真实g++.exe。
确认工具链是否已就绪
CLion 启动时会自动扫描系统环境变量里的 gcc、g++、clang++、cl、cmake 等命令，但扫描失败很常见——尤其是 Windows 下未将 MinGW 或 MSVC 的 bin 目录加入 PATH，或 macOS 上用 brew install gcc 安装后未软链接到 /usr/local/bin。别依赖“自动检测成功”这个假象。
验证方式很简单：打开终端（Terminal），运行：
which cmake && which g++
如果任一命令无输出，说明 CLion 后续也无法调用。此时必须手动配置工具链：
- 进入 Settings | Build, Execution, Deployment | Toolchains
- 点击
+添加新工具链，类型选MinGW/Visual Studio/Clang - 在
CMake字段填入绝对路径（如C:/Program Files/JetBrains/CLion 2026.2/bin/cmake/win/x64/bin/cmake.exe） - 编译器字段务必指向真实可执行文件（如
g++.exe，不是mingw32-g++.exe这类别名）
CMakeLists.txt 与项目结构不匹配时怎么救
新建项目选了 C++ Executable，但后续删了 main.cpp 或新增了多个源文件，CLion 不会自动更新 add_executable() 的参数列表——它只在首次创建或显式触发 “Reload CMake project” 时同步。结果就是构建时报错：Cannot find source file: main.cpp 或链接失败。
有三种应对方式，按优先级排序：
- 右键项目根目录 → Reload CMake project（最常用，但仅对已声明在
CMakeLists.txt中的文件生效） - 手动编辑
CMakeLists.txt，确保add_executable(myapp main.cpp util.cpp)显式列出所有源文件 - 用
file(GLOB SRC_LIST "*.cpp")+add_executable(myapp ${SRC_LIST})，但注意：GLOB 不支持递归，且修改文件后需手动 reload，否则增量构建会漏掉新文件
Qt 项目必须设 CMAKE_PREFIX_PATH
CLion 对 Qt 的支持完全依赖 CMake 找到 Qt6Config.cmake 或 Qt5Config.cmake。不设 CMAKE_PREFIX_PATH，find_package(Qt6 REQUIRED COMPONENTS Core Widgets) 就会报错：Could not find a package configuration file provided by "Qt6"。
设置位置有三个等效入口，选一个即可：
- 在 Settings | Build, Execution, Deployment | CMake 的
CMake options栏填：-DCMAKE_PREFIX_PATH=C:/Qt/6.7.1/msvc2019_64 - 直接写进
CMakeLists.txt顶部（推荐用于团队协作）：set(CMAKE_PREFIX_PATH "C:/Qt/6.7.1/msvc2019_64") - 新建项目向导里，在 “Qt installation path” 输入框中填写（仅限新项目）
注意路径末尾不能带 /lib/cmake/Qt6 这类子目录，必须是 Qt 安装根目录或 Qt6.7.1/6.7.1/msvc2019_64 这种带 toolchain 的完整路径。
单文件快速运行要不要配 CMake？
不需要。CLion 自带的 C/C++ Single File Execution 插件会在后台为你生成临时 CMake 配置，你只需右键 main.cpp → Run 'main'，它自动调用 g++ -std=c++17 main.cpp -o main 编译并执行。
但要注意两个硬限制：
- 该插件不支持跨文件依赖（比如
main.cpp调用了util.h和util.cpp，就会编译失败） - 若项目已存在
CMakeLists.txt，插件会退化为普通 CMake 构建逻辑，此时必须保证add_executable()包含该文件，否则右键运行仍是灰色 - 插件默认使用系统 PATH 中第一个
g++，不走 CLion 当前激活的 Toolchain，调试时断点可能无法命中
真正需要 CMake 的场景只有一个：当你的代码开始涉及头文件组织、第三方库链接、条件编译或目标类型切换（exe/lib/shared）时，就该把临时单文件收进正式 CMake 项目结构里了——这时候再回头配 Toolchains 和 CMake options，比后期迁移更省事。
