新建的.cpp文件不被编译，因为CLion仅依据CMakeLists.txt中add_executable()或add_library()显式列出的源文件构建，未添加则CMake完全忽略该文件。
CLion里新建CMake工程后，加个.cpp或.h文件默认不参与构建——必须手动让CMake知道它该编译谁、链接谁、找头文件去哪找。
为什么新建的.cpp文件不被编译？
CLion不会自动把项目目录下所有.cpp文件塞进构建目标。它只认CMakeLists.txt里明确列出的源文件。你右键新建一个utils.cpp，文件虽在磁盘上，但只要没写进add_executable()或add_library()的参数列表里，CMake就完全无视它。
常见错误现象：
- 绿色运行按钮是灰色的
- 编译成功但函数调用报
undefined reference -
#include "utils.h"提示“file not found”，即使utils.h就在同级目录
根本原因：CMake不知道这个文件存在，更不知道它属于哪个目标。
怎么把新文件正确加入构建？
有三种可靠方式，按推荐顺序排列：
- 在CLion中右键点击新创建的
.cpp或.h文件 → 选 Add to CMake project（注意不是“Add to project”）→ CLion会自动在CMakeLists.txt对应add_executable()或add_library()里追加该文件路径 - 手动编辑
CMakeLists.txt，在add_executable(myapp ...)括号内补上相对路径，例如：add_executable(myapp main.cpp src/utils.cpp include/utils.h) - 如果文件在子目录（如
src/network/），建议用file(GLOB_RECURSE SRC_FILES "src/*.cpp")收集，但要警惕GLOB的缓存问题：新增文件后需手动触发Reload CMake Project
注意：include_directories()只影响头文件搜索路径，不负责源文件编译；target_include_directories()才是现代CMake推荐写法，作用范围更精确。
多目录结构下CMakeLists.txt怎么写？
典型分层结构（如drivers/、core/、app/）需要父子CMakeLists.txt配合：
- 根目录
CMakeLists.txt里写add_subdirectory(drivers)和add_subdirectory(app) -
drivers/CMakeLists.txt定义add_library(drivers STATIC driver_a.cpp driver_b.cpp)，并用target_include_directories(drivers PUBLIC inc)导出头文件路径 -
app/CMakeLists.txt里用target_link_libraries(myapp PRIVATE drivers)链接，这样app/main.cpp才能#include "driver_a.h"
关键点：子目录CMakeLists.txt必须存在且语法合法；父目录不显式列出子目录下的源文件；PUBLIC/PRIVATE/INTERFACE控制头文件可见性，错用会导致编译失败或隐式依赖。
容易被忽略的坑
最常踩的三个点：
-
CMakeLists.txt修改后没点CLion右上角的 Reload CMake Project 小箭头 → 改了等于白改 - 误删了
project(...)这一行，导致后续所有add_*命令失效（CMake要求project()必须在最前） - 路径写错：用
./src/utils.cpp不如直接写src/utils.cpp；CMake解析路径基于CMakeLists.txt所在目录，不是当前工作目录
复杂点在于，CMake缓存变量（比如CMAKE_BUILD_TYPE）一旦设错，可能影响整个构建行为，而CLion的UI里改了不一定实时同步到缓存——最好养成习惯：改完配置，先看CMake工具窗口里的输出日志，确认configure阶段没警告。
