CLion项目初始化需正确配置C++ Executable模板、匹配的语言标准及无中文/空格的项目路径；CMakeLists.txt自动生成但不覆盖已有文件，add_executable名称须与project一致；工具链未就绪会导致“Configuring”卡住，完成标志是状态栏显示“CMake: Loaded”且main.cpp出现绿色运行按钮。
CLion 项目初始化不是“点一下就完事”的动作，它本质是触发 CMake 配置 + 工具链绑定 + 文件结构生成的组合过程。选错模板或跳过关键设置，后续会卡在构建失败、main.cpp 不参与编译、或调试器无法启动上。
新建 C++ 项目时必须确认的三个参数
在 New Project 对话框中，以下三项直接影响初始化是否成功：
-
C++ Executable模板必须被选中（不要选Empty Project或CMake Project—— 后者不自动生成main.cpp） -
Language standard要匹配你代码里实际用的特性（比如用了std::format就得选 C++20，选 C++17 会导致cmake configure报错Unknown compiler flag） - 项目路径不能含中文、空格或特殊符号（Windows 下路径含
Program Files或 macOS 下含Documents可能导致工具链检测失败）
CMakeLists.txt 自动生成但不等于可用
CLion 会为你生成一个最简 CMakeLists.txt，内容类似：
cmake_minimum_required(VERSION 3.31) project(cmake_testapp) set(CMAKE_CXX_STANDARD 20) add_executable(cmake_testapp main.cpp)
但要注意：
- 如果项目目录下已有
CMakeLists.txt（哪怕只是空文件），CLion 不会覆盖它，也不会提示；此时新建的main.cpp很可能不会被加入构建目标 -
add_executable()中的可执行名必须和project()名一致，否则运行按钮灰色不可点（CLion 默认把第一个add_executable当作主 target） - 若你手动改过
CMakeLists.txt后构建失败，先点File → Reload project，而不是重启 CLion —— 否则 CMake 缓存可能残留旧状态
工具链未就绪会导致初始化卡在“Configuring”
CLion 启动后会自动扫描系统中的编译器，但常见失效场景有：
- macOS 上没装 Xcode 命令行工具：运行
xcode-select --install后需重启 CLion - Windows 上只装了 Visual Studio 但没勾选 “C++ build tools”：CLion 会 fallback 到 MinGW，但某些 Qt 或 STM32 项目需要 MSVC 工具链，此时必须进
Settings → Toolchains手动指定Visual Studio而非MinGW - Linux 上只装了
gcc没装g++：apt install g++后，在 CLion 的Toolchains页面点右上角刷新图标
初始化完成的明确信号是：右下角状态栏出现 CMake: Loaded，且 main.cpp 左侧出现绿色三角形运行按钮。如果按钮始终灰色，大概率是 add_executable 名称不匹配，或工具链未真正绑定成功 —— 这个细节最容易被忽略。
