CLion新建C++工程的核心前提是存在且可解析的CMakeLists.txt；必须选C++ Executable类型，项目名禁用中文和空格，建议选C++20标准，并确保Toolchains中编译器状态为“Valid”。
CLion 新建 C++ 工程的核心前提只有一个：CMakeLists.txt 必须存在且能被正确解析，否则绿色运行按钮永远是灰色的。
点击 New Project 后必须选对项目类型
在欢迎界面点 New Project，左侧列表里一定要选 C++ Executable —— 这是唯一会自动生成完整 CMake 构建配置的选项。选错成 “Empty Project” 或 “CMake Project”（手动模板），CLion 就不会帮你写 add_executable()，也不会关联 main.cpp，后续所有编译、运行、调试都会失败。
- 项目名称别用中文或空格，比如
HelloWorld可以，我的第一个程序不行 - Language standard 建议直接选
C++20，避免后期改标准时CMAKE_CXX_STANDARD和编译器实际行为不一致 - 点 Create 后，CLion 会立刻尝试执行 CMake Configure；如果卡住或报错，说明工具链没配好，不是项目本身的问题
CMakeLists.txt 自动生成但不能盲目信任
新建成功后，根目录下会出现一个 CMakeLists.txt，内容类似：
cmake_minimum_required(VERSION 3.31) project(MyCppProject) set(CMAKE_CXX_STANDARD 20) add_executable(MyCppProject main.cpp)
这四行是刚够跑起来的最小集，但有几个关键点容易被忽略：
立即学习“C++免费学习笔记（深入）”；
-
cmake_minimum_required版本由 CLion 捆绑的 CMake 决定，一般不用动；但如果你手动替换了系统 CMake，版本低于此值就会报错 -
add_executable()的第一个参数是生成的可执行文件名，第二个参数是源文件路径；如果之后你把main.cpp改名或移走，这里必须同步改，否则构建失败 - 如果想加多个源文件，不能写成
add_executable(app a.cpp b.cpp c.cpp)就完事——得确保它们都在同一目录，或用相对路径明确写出，比如src/main.cpp
工具链未配置会导致新建即失败
即使选对了 C++ Executable，如果 CLion 找不到可用的编译器，它会停在 “Configuring project…” 阶段，右下角弹出提示：“No toolchain defined”。这不是 CMake 报错，而是 IDE 层面的环境缺失。
- Windows 用户最省事的方式是直接用 CLion 捆绑的 MinGW-w64（默认启用），无需额外安装；若想用 MSVC，则必须先装好 Visual Studio 2019/2022，并确保安装了“C++ build tools”组件
- macOS 用户需确认 Xcode command line tools 已安装：
xcode-select --install - Linux 用户检查是否装了
build-essential（Ubuntu/Debian）或base-devel（Arch），否则g++命令根本不存在 - 进
File | Settings | Build, Execution, Deployment | Toolchains看一眼，Status 列显示 “Valid” 才算真正就绪
真正容易被忽略的是：CLion 在新建项目时不会校验工具链是否真能工作，只检查是否存在。哪怕你指定了一个路径错误的 MinGW，它也会先生成项目再报错——所以第一次点运行前，务必确认 Toolchains 页面里那个绿色对勾是实心的。
