最稳妥方式是通过file | new project创建c++ executable项目，它自动生成含main.cpp和标准cmakelists.txt的结构，指定cmake_minimum_required、project、c++标准及add_executable；选empty project需手动配置易出错。
直接用 File | New Project 创建 C++ 可执行项目是最稳妥的方式，其他路径（比如“打开单个文件”或手动配 CMakeLists.txt）容易漏掉调试符号、标准库识别或工具链绑定。
选对模板：C++ Executable 而不是 Empty Project
CLion 的 C++ Executable 模板会自动生成带 main.cpp 和基础 CMakeLists.txt 的结构，包含 cmake_minimum_required、project、set(CMAKE_CXX_STANDARD) 和 add_executable 四行关键内容。如果选 Empty Project，你得自己手写全部 CMake 配置，连编译器标准都得手动指定，极易出错。
- 语言标准建议选
C++20或C++17，避免默认C++14导致现代特性报错 - 项目名不要含空格或中文，否则某些工具链（尤其是 MinGW）在生成路径时会失败
- 创建后立刻检查右下角 CMake 工具窗口是否显示 “Loaded” —— 若卡在 “Configuring”，大概率是工具链未配置或 CMake 版本不兼容
工具链必须提前就绪，否则新建即失败
CLion 不自带编译器，C++ Executable 模板依赖已配置的工具链。没配好就点创建，项目能建出来但无法构建，运行按钮灰掉，控制台报 Cannot find compiler 'g++' 或类似错误。
- macOS：装 Xcode 命令行工具（
xcode-select --install），CLion 通常自动识别clang++ - Windows：推荐 MinGW-w64（非旧版 MinGW），下载后在
Settings | Build, Execution, Deployment | Toolchains中指定g++.exe路径 - Linux：确保系统已安装
build-essential（Ubuntu/Debian）或gcc-c++（CentOS/RHEL） - 工具链里“Debugger”字段若为空，调试会直接失败；Clang 用户需确认 lldb 是否可用，MSVC 用户注意 Windows SDK 版本匹配
运行/调试前务必确认 main.cpp 在 targets 里
新建项目后，CMakeLists.txt 中的 add_executable 必须显式包含 main.cpp。有时因文件重命名、误删或添加新源文件操作不当，这行会被改错，导致构建成功但无输出，或提示 undefined reference to `main'。
- 典型错误写法：
add_executable(myapp foo.cpp)—— 漏了main.cpp - 正确写法：
add_executable(myapp main.cpp)，多个源文件则写成add_executable(myapp main.cpp utils.cpp) - 如果加了新
.cpp文件但没加进add_executable，CLion 编辑器里该文件名会标灰，且 Ctrl+Click 进不去定义 - 修改
CMakeLists.txt后，右上角会出现黄色 “Reload project” 提示，必须点它，否则改动不生效
最易被忽略的是：CLion 默认把 main.cpp 放在项目根目录，但如果你手动建了子目录再拖入 main.cpp，add_executable 中的路径必须同步更新为 src/main.cpp，否则构建时找不到文件 —— 这类路径错误不会报红，只会在构建日志末尾出现 file not found，极难定位。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
