CLion新手创建项目核心是选对C++ Executable类型、配好工具链、确认CMakeLists.txt自动生成逻辑;三者无误则编译运行基本顺畅。

CLion 新手创建项目,核心不是“点哪里”,而是搞清三件事:选对项目类型、配好工具链、确认 CMakeLists.txt 生成逻辑。只要这三点没卡住,后续编译运行基本不会出问题。
选 C++ Executable 还是其他模板?
绝大多数新手直接选 C++ Executable 就够了。它会自动生成最小可用的 CMakeLists.txt 和 main.cpp,适合练手、写算法、跑小工具。
- 别选
Empty Project:没有预置构建配置,新手容易卡在“点了 Run 却提示 no target” - Qt/STM32/Gradle 项目要额外装 SDK 或插件,首次创建建议跳过
- 如果已有源码但无 CMakeLists.txt,选
Open而非New Project,否则 CLion 会强行覆盖或报错
工具链没自动识别?先看 PATH 和安装路径
CLion 启动时会扫描系统 PATH 和常见路径(如 C:\mingw64\bin)找 g++.exe。如果没找到,你会在右下角看到 “No toolchain configured” 提示。
- 检查是否真的把 MinGW-w64 的
bin目录加进了系统 PATH(不是用户 PATH) - 路径里不能有中文、空格或特殊符号,比如
C:\Program Files\mingw64就容易失败,换成C:\mingw64更稳 - CLion 内置的捆绑 MinGW(13.1 版)只在首次启动时自动启用,如果跳过了欢迎页,就得手动进
Settings > Build > Toolchains点+ Add选Mingw并指定路径
CMakeLists.txt 为什么一创建就报错?
新建 C++ Executable 项目后,CLion 会生成一个基础 CMakeLists.txt,但如果你改过项目名、删过文件、或用外部编辑器动过它,CMake 可能因缓存或语法错误无法 reload。
- 常见错误:
Unknown CMake command "project"—— 说明文件开头少了cmake_minimum_required(VERSION 3.28) - 修改后必须点右上角
Reload project(闪电图标),不能只靠自动检测 - 如果 CMake 面板一直显示 “Loading...”,可尝试
File > Reload project from disk强制刷新
运行 main.cpp 却提示 “No executable specified”?
这不是代码问题,是 CLion 没把 main.cpp 关联到可执行目标。CMake 里必须显式声明 add_executable(),而新手常误删或改名了这个函数的参数。
- 检查
CMakeLists.txt中add_executable()的第一个参数(目标名)是否和项目名一致,第二个参数是否包含main.cpp - 如果手动添加了新 .cpp 文件,记得同步加进
add_executable()的文件列表,或者用file(GLOB ...)动态收集(不推荐新手用) - 运行配置里选错 target 是高频坑:点击右上角下拉框,确认选的是你项目名对应的 target,不是
all或clean
真正容易被忽略的,是 CLion 对 CMake 缓存的强依赖——它不像命令行那样每次 clean 都重来。一旦工具链或 CMakeLists.txt 改动后没 reload,后续所有构建行为都可能基于旧状态,报错信息却指向新位置,让人反复怀疑代码写错了。


















