根本原因是CMakeLists.txt未正确生成或未被CLion加载；新建项目必须选C++ Executable类型，确保自动生成CMakeLists.txt和main.cpp，并配置好工具链、保持源文件路径与add_executable一致。
CLion 新建 C++ 项目失败、绿色运行按钮灰色、main.cpp 不被识别——根本原因几乎总是 CMakeLists.txt 没正确生成或没被 CLion 加载，而不是代码写错了。
点击 New Project 后选错类型，CMake 就不会自动初始化
必须在新建项目对话框左侧明确选择 C++ Executable（不是 “Empty Project” 或 “C++ Library”）。选错会导致 CLion 不生成 CMakeLists.txt，也不创建 main.cpp，后续所有构建操作都无从谈起。
- 如果误选了 “Empty Project”，项目根目录下只有空文件夹，
CMake工具窗口不会出现，右下角也看不到配置进度 -
C++ Executable是唯一能触发 CLion 自动生成标准CMakeLists.txt+main.cpp的选项 - 选中后右侧的
Language standard建议直接设为C++20，避免后续手动改set(CMAKE_CXX_STANDARD 20)
CMakeLists.txt 存在但灰色按钮仍不亮，大概率是工具链未配置
即使 CMakeLists.txt 在项目根目录，CLion 仍可能显示 “No toolchain configured” 或卡在 “Loading project…”。这是因为 CLion 不知道用哪个编译器去执行 cmake 命令。
- Windows 用户：检查是否已安装 MinGW-w64 或 MSVC，并在
Settings | Build, Execution, Deployment | Toolchains中手动添加路径（如C:\mingw64） - macOS 用户：确保 Xcode Command Line Tools 已安装（
xcode-select --install），否则clang不可用 - Linux 用户：确认
g++和make在$PATH中（which g++应返回有效路径） - 配置完工具链后，需点击
CMake工具窗口右上角的Reload project图标（循环箭头），不能只等自动刷新
main.cpp 放错位置，add_executable 就找不到源文件
CLion 默认只认项目根目录下的 main.cpp。如果你手动在 src/ 或其他子目录里新建了 hello.cpp，但 CMakeLists.txt 里仍是 add_executable(project_name main.cpp)，那构建会失败，且错误提示非常隐晦（常表现为 “Target not built”）。
立即学习“C++免费学习笔记（深入）”；
- 最稳妥做法：保持
main.cpp在项目根目录，不要移动它 - 若必须分目录，需同步修改
CMakeLists.txt中的路径，例如：add_executable(project_name src/hello.cpp) - 注意大小写：Windows 下不敏感，Linux/macOS 下
Src/hello.cpp和src/hello.cpp是两个不同路径 - 别勾选 “Add to targets”：在新建文件弹窗里这个选项默认开启，但对单入口项目它是冗余甚至有害的
CMake 配置失败时，CMake 工具窗口比控制台日志更准
很多人习惯看底部 Build 或 Run 标签页的输出，但 CMake 初始化阶段的报错其实集中在 CMake 工具窗口（View | Tool Windows | CMake）。这里会直接显示 cmake_minimum_required 版本不匹配、project() 重复定义、路径含中文等真实阻断点。
- 常见错误信息示例：
CMake Error at CMakeLists.txt:3 (project): project PROJECT_NAME must be called before add_executable - 如果看到
No CMakeLists.txt found in the selected directory，说明你当前打开的是子文件夹，不是项目根目录 - 修改
CMakeLists.txt后，必须手动触发重载（右键 →Reload CMake Project），CLion 不会自动响应文件保存
真正卡住的地方往往不是语法，而是 CLion 对 CMake 项目的“信任机制”：它只相信根目录下有合法 CMakeLists.txt、工具链就位、且源文件路径与 add_executable 完全一致。三者缺一，绿色按钮就不会亮——这不是 bug，是设计使然。
