最稳妥方式是通过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'。
立即学习“C++免费学习笔记(深入)”;
- 典型错误写法:
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,极难定位。


















