CLion安装后需先配置Toolchains和CMake，否则新建项目会报“Cannot find compiler”或卡在“Loading project”；必须设置编译器路径、指定CMake可执行文件、使用纯英文路径创建项目，并确保CMakeLists.txt正确配置后才能正常编译运行。
CLion 安装完不能直接写代码，必须先完成工具链和 CMake 配置，否则新建项目会报错“Cannot find compiler”或卡在“Loading project”。
首次启动后必须配置 Toolchains（工具链）
CLion 不自带编译器运行时，只提供 MinGW 或 Clang 的路径绑定能力。Windows 默认带 MinGW11.0，但不会自动注册到系统 PATH；macOS 依赖 xcode-select --install 安装的 clang；Ubuntu 需手动 apt install build-essential 并确保 gcc 可执行。
- 打开
File → Settings → Build, Execution, Deployment → Toolchains（macOS 是CLion → Preferences） - 点右上角
+→ 选MinGW（Windows）或Clang（macOS）或GNU（Linux） - 检查
C Compiler和C++ Compiler路径是否真实存在且可执行（例如 Windows 上是mingw64/bin/gcc.exe） - 若路径为空或标红，说明 CLion 没找到编译器——别点“OK”，先去终端运行
gcc --version或clang --version确认是否可用
CMake 配置不通过会导致项目无法生成
CLion 本质是 CMake 驱动的 IDE，所有 C/C++ 项目都靠 CMakeLists.txt 构建。如果 CMake 不识别，新建项目后连 main.cpp 都不会自动生成。
- 在同一个
Toolchains设置页下方，展开CMake项 - 点右上角
+→ 添加一个配置，Name填Debug即可，默认会关联刚配好的工具链 - 确认
CMake executable指向的是真实路径：Windows 是bin/cmake.bat（CLion 自带），macOS/Linux 是/usr/bin/cmake或/opt/homebrew/bin/cmake - 如果提示 “CMake is not found”，不要手动下载 CMake 安装包——CLion 自带，路径通常为
CLion.app/Contents/bin/cmake/mac/cmake（macOS）或bin/cmake/win/cmake.exe（Windows）
新建项目时语言标准和路径必须全英文
哪怕你已装好中文语言包，项目路径含中文或空格仍会导致 CMake 解析失败，错误信息常为 Parse error in cmake file 或 Unknown CMake command "project"。
- 点击欢迎页
New Project，Location必须选纯英文路径，例如D:/projects/hello_c，不能是D:/我的项目/测试 -
C++ Standard下拉框选C++17或更高（2026 年新项目建议直接选C++20） - 勾选
Add sample code可自动生成带main()的main.cpp，避免手写时漏掉#include <iostream>导致编译报红 - 点
Create后，右下角状态栏会显示 “Configuring project…” —— 此时别动，等进度条走完再编辑文件
最容易被忽略的是：CLion 的“运行”按钮（绿色三角）默认调用 CMake 构建目标，不是直接执行 g++ main.cpp -o a.out。如果改过 CMakeLists.txt 但没点右上角 Reload CMake project，改了也白改。
