直接创建c++ executable项目即可自动生成标准cmake项目；按钮变灰、构建失败或main.cpp未编译，均因cmakelists.txt初始配置错误或修改后未重载——必须包含cmake_minimum_required、project、add_executable三行，且目标名与project一致、源文件名准确，修改后须点击闪电图标重载。
直接创建 C++ Executable 项目即可生成标准 CMake 项目，无需手动写 CMakeLists.txt —— 但按钮变灰、构建失败、main.cpp 不参与编译，几乎全是 CMakeLists.txt 初始配置或后续修改不当导致的。
新建项目时选对模板和语言标准
CLion 的「New Project」不是单纯建文件夹，而是触发完整 CMake 初始化流程。关键动作只有两个：
- 左侧必须选
C++ Executable（不是 Empty Project 或其他） - 「Language standard」务必选你实际要用的标准，比如
C++17或C++20；选错会导致CMAKE_CXX_STANDARD写入错误值，后续启用新特性（如std::format）会编译失败
点击 Create 后，CLion 自动创建 CMakeLists.txt 和 main.cpp，并立即执行一次 cmake configure。如果此时绿色运行按钮仍是灰色，说明 configure 阶段已失败 —— 不是代码问题，是 CMake 脚本没过。
CMakeLists.txt 初始内容必须包含 add_executable
自动生成的 CMakeLists.txt 应该长这样（以项目名 ArgsDemo 为例）：
cmake_minimum_required(VERSION 3.26) project(ArgsDemo) set(CMAKE_CXX_STANDARD 17) add_executable(ArgsDemo main.cpp)
最容易被删掉或改错的是最后一行：add_executable 必须存在，且第一个参数（目标名）要和 project() 名一致（或至少与后续运行配置匹配），第二个参数必须列出源文件（如 main.cpp）。常见错误包括：
- 误删
add_executable行 → 没有构建目标，CLion 找不到可运行的二进制 - 把
main.cpp写成main.c或漏写扩展名 → CMake 不识别为源文件，不参与编译 - 目标名含空格或特殊字符（如
My App）→ CMake 解析失败，configure 中断
运行按钮变灰？先看 CMake 工具窗口输出
灰色按钮 = CLion 没检测到有效可执行目标。不要急着重装或删项目，打开 View | Tool Windows | CMake，观察底部日志：
- 出现
Configuring incomplete, errors occurred!→ 看紧挨着的上几行，通常是Unknown CMake command "find_package"这类语法错误，或路径不存在 - 日志停在
Generating done但没Build files have been written→ 可能工具链未正确选择（比如 Windows 上没选 MSVC 或 MinGW，macOS 上没选 Clang） - 完全没日志或卡住 → 检查 Settings | Build, Execution, Deployment | Toolchains 是否配置了可用的编译器
注意：CLion 不会自动重载 CMakeLists.txt 修改。每次手动改完，必须点右上角 Reload CMake project（闪电图标）或按 Ctrl+Shift+O，否则更改无效。
添加新源文件后必须显式加入目标
右键新建 calc.cpp，CLion 会弹提示「Add to targets」。如果你点了「Don’t ask again」然后取消勾选，这个文件就只是普通文本——不会编译，也不会出现在任何 add_executable 参数里。
- 补救方法：打开
CMakeLists.txt，找到add_executable(...)行，在括号内末尾加英文逗号和calc.cpp - 更稳妥的做法：删掉旧的
add_executable，重写为add_executable(ArgsDemo main.cpp calc.cpp)，避免遗漏空格或换行符 - 如果想为
calc.cpp单独建一个可执行文件（而非合并进主程序），需新增一行add_executable(calc calc.cpp)，然后 Reload
真正容易被忽略的，是「修改 CMakeLists.txt 后忘记 Reload」和「以为文件出现在项目树里就等于被构建系统识别」——CLion 的项目结构视图只反映文件系统，CMake 才决定哪些文件参与构建。
