clion不会自动将文件纳入cmake构建系统，必须显式声明：新建.cpp/.cu文件需右键“添加到cmake项目”，.cu文件还需启用cuda语言支持并设置属性；头文件须通过include_directories()声明路径；删除文件也需同步移除cmake引用。
CLion 不会自动把文件加进构建系统，必须显式声明——否则编译报错、跳转失效、补全失灵都是常态。
文件在项目树里但编译报“undefined reference”或“no such file or directory”
这是最典型的误判：看到 .cpp 或 .h 出现在左侧项目视图，就以为它已被 CMake 纳入。实际 CLion 只是做了文件系统映射，CMake 根本不知道它的存在。
- 右键点击新添加的
.cpp文件 → 选 添加到 CMake 项目（如果没弹出提示，说明该文件尚未被识别为源码） - 若文件已存在但未加入目标，需手动编辑
CMakeLists.txt，在add_executable()或add_library()的括号内追加该文件路径，例如：add_executable(myapp main.cpp utils.cpp) - 头文件（
.h或.hxx）本身不参与编译，但必须确保其所在目录已通过include_directories()或target_include_directories()告知 CMake
添加 .cu 或 .cuh 文件时链接失败
CUDA 文件需要额外的 CMake 识别支持，仅当成普通 C++ 文件添加会导致 nvcc 不被调用、设备代码不编译。
- 新建文件时，在右键菜单中选择 新建 → CUDA 源文件（后缀自动设为
.cu），而非“C/C++ 源文件” - 确保
CMakeLists.txt中已启用 CUDA 支持：enable_language(CUDA)，且project(... LANGUAGES CXX CUDA) - 若使用
add_executable()，需显式指定 CUDA 文件，并设置属性：set_property(TARGET myapp PROPERTY CUDA_SEPARABLE_COMPILATION ON) - 不要依赖 CLion 自动推断语言标准——CUDA 项目中
CMAKE_CUDA_STANDARD和CMAKE_CXX_STANDARD必须分别设置
批量添加已有文件夹下的多个源文件
直接把一堆 .cpp 复制进 src/ 目录后，CLion 会显示它们，但 CMake 仍一无所知。
- 在项目树中按住
Ctrl（Windows/Linux）或Cmd（macOS）多选文件 → 右键 → 添加到 CMake 项目 - 若目标是库而非可执行文件，注意选择正确的 target（如
mylib而非myapp） - 更稳妥的做法是先在
CMakeLists.txt中用file(GLOB ...)收集，但注意：CLion 对GLOB的索引支持有限，新增文件后常需手动 Reload CMake Project - 删除文件时同理：仅在文件系统中删掉，CMake 缓存里还留着引用，下次构建就会失败；务必右键文件 → 从 CMake 项目中移除
最容易被忽略的是：CLion 的“添加到 CMake 项目”操作只修改 CMakeLists.txt，不会自动更新 include_directories() 或 target_include_directories()。头文件路径错一个字符，#include 就失效——这和文件是否在项目树里完全无关。
