C++引入头文件报架构符号未找到，引入cpp文件却正常

这个问题我之前踩过坑，本质就是链接器找不到函数的实际实现代码，咱们一步步把它捋明白：

问题根源 #

当你只#include "util.h"时，编译器能看到print函数的声明（知道有这么个函数存在），但到了链接阶段，它需要找到这个函数的具体实现逻辑——也就是util.cpp里的代码。如果你的CMakeLists.txt没把util.cpp加入编译目标的源文件列表，链接器就找不到对应的符号，自然会抛出这个错误。

而直接#include "util.cpp"虽然能编译通过，但这是个非常不好的习惯：相当于把util.cpp的代码直接复制到main.cpp里，不仅会导致重复编译（如果其他文件也这么做），还完全违背了头文件与源文件分离的设计原则。

正确解决方案 #

修改你的CMakeLists.txt，把util.cpp添加到可执行目标的源文件列表里就搞定了：

假设你的项目结构是这样的：

项目根目录/
├── main.cpp
├── util.h
├── util.cpp
└── CMakeLists.txt

更新后的CMakeLists.txt应该写成这样：

cmake_minimum_required(VERSION 3.10)
# 替换成你的项目名称
project(MyToolProject)

set(CMAKE_CXX_STANDARD 11)

# 把main.cpp和util.cpp都作为编译源文件传入
add_executable(MyToolProject main.cpp util.cpp)

这样CMake会分别编译main.cpp和util.cpp生成独立的目标文件，链接阶段就会把两者合并，链接器自然能找到print函数的实现了。

额外提醒 #

• 永远不要#include .cpp文件，头文件（.h）只放函数声明、类定义等接口内容，实现代码全部放在.cpp文件中
• 如果你的工具函数数量较多，可以考虑把它们打包成静态库或动态库，再链接到主程序，这也是大型项目里的常用做法

内容的提问来源于stack exchange，提问作者Nur L