工具链未配置是clion新建工程后无法编译运行的首要原因，需在settings→toolchains中正确指定编译器、cmake和调试器路径，确保三者均检测通过并显示绿色对勾，否则cmake配置失败、运行按钮变灰、代码补全失效。
新建工程后，CLion 默认会基于 CMake 自动生成项目结构，但**工具链未配置时无法编译运行**——这是最常卡住的第一步。你看到 main.cpp 文件却点不了运行按钮，或点击后报错 Cannot find compiler，基本就是这个原因。
检查并配置 Toolchain（工具链）
CLion 不自带编译器，必须显式指定 C/C++ 编译器、CMake 可执行文件和调试器。路径不对、版本缺失、权限不足都会导致构建失败。
- 打开
Settings | Build, Execution, Deployment | Toolchains（macOS 是Preferences） - 默认显示
Bundled MinGW（Windows）或Xcode command line tools（macOS），但需确认检测状态：右侧应显示绿色对勾，且Compiler、CMake、Debugger三栏均非空 - 若显示
Not found或路径为空：- Windows：选
MinGW→ 点击右侧Download自动安装捆绑版（MinGW-w64 13.1），或手动指定已安装的 MinGW-w64 路径（如C:\mingw64\bin\gcc.exe） - macOS：运行
xcode-select --install安装命令行工具，再回到设置中点击Reload按钮 - Linux：确保已安装
build-essential和cmake，CLion 通常能自动识别/usr/bin/gcc和/usr/bin/cmake
- Windows：选
- 注意：如果使用自定义 MinGW 安装但 CLion 仍报错，大概率是没装
mingw32-gcc-g++或mingw64-gcc-g++包——仅装mingw32-base不够
确认 CMakeLists.txt 是否生成正确
新建 C++ 工程时，CLion 会自动生成 CMakeLists.txt，但内容是否有效取决于工具链是否就绪。如果工具链配置失败，CMake 配置阶段就会中断，后续所有功能（代码补全、跳转、构建）都不可用。
- 查看底部状态栏：若显示
CMake: Loading...卡住，或弹出Failed to configure project，说明 CMake 找不到编译器 - 打开
CMakeLists.txt，检查前两行是否类似：cmake_minimum_required(VERSION 3.22) project(untitled)
这是正常的；但如果出现
set(CMAKE_CXX_COMPILER "xxx")且路径明显错误（比如指向不存在的clang-cl.exe），说明上次配置残留干扰了当前项目 - 解决方法：删除项目根目录下的
cmake-build-debug（或cmake-build-release）文件夹，然后点击右上角Reload CMake project图标（两个循环箭头）
运行配置是否自动创建
工具链和 CMake 都正常后，CLion 会为每个 add_executable() 目标自动生成一个运行配置。但如果你改过 CMakeLists.txt，或新建了第二个 main.cpp，它不会自动追加配置。
- 右上角运行按钮旁的下拉菜单里，应能看到类似
untitled [Debug]的条目；如果没有，说明 CMake 没识别到可执行目标 - 检查
CMakeLists.txt中是否有add_executable(untitled main.cpp)—— 名称（untitled）必须与project()名一致，否则 CLion 可能忽略该 target - 想运行单个
.c或.cpp文件（不依赖 CMake）？右键文件 →Run 'xxx'，CLion 会创建一个C/C++ File类型的临时配置，此时不走 CMake 流程，但只适用于简单验证
真正容易被忽略的是：CLion 的工具链配置是**按项目存储的**，但当你从“Open”打开已有项目而非“New Project”，它可能沿用旧项目的 Toolchain 设置，而那个设置指向已被卸载的 MinGW 或已失效的 WSL 路径——此时必须手动进 Toolchains 页面重新选择或重置，不能只靠 Reload CMake。
