C++仅引入类头文件编译main.cpp时出现Linker Error链接错误

你遇到的undefined reference属于链接阶段错误，和头文件引入逻辑无关。
C++代码从源码到可执行程序分为两个独立阶段：

• 编译阶段：每个.cpp源文件会被单独处理，编译为二进制目标文件。这个阶段#include头文件的作用仅仅是向当前编译的源文件暴露类、函数的声明信息，让编译器知道调用的方法签名是否合法，不会自动加载其他.cpp文件里的实现代码。
• 链接阶段：链接器会收集所有编译生成的目标文件，把代码里的函数、方法调用和对应的实现地址做绑定。你之前报错的核心原因是编译时只传入了main.cpp，没有把classheader.cpp纳入编译流程，链接器找不到类成员方法的具体实现，自然抛出未定义引用错误。

你提到在main.cpp里直接引入classheader.cpp可以正常运行，本质是让预处理器把classheader.cpp的全部代码直接插入到main.cpp中，两个文件被合并成同一个编译单元处理，相当于变相把实现代码塞到了main.cpp里，当然不会触发链接错误。但这种写法完全不符合C++开发规范，会大幅增加不必要的重复编译开销，还很容易引发符号重定义问题，绝对不要在正式项目里这么写。

你了解的「类声明放.h头文件、实现放.cpp源文件、使用时仅引入头文件」的开发规范是完全可行的，属于行业通用标准实践，报错和规范本身无关，只是构建操作步骤有误。

不需要修改现有代码的文件拆分逻辑，根据你使用的编译环境选择对应处理方式即可：

命令行手动编译 #

编译命令必须把所有涉及到的源文件都作为参数传给编译器，不能只编译main.cpp：

• 如果你用g++/clang++编译器，执行以下命令即可：

g++ main.cpp classheader.cpp -o animal_demo

• 如果你用Windows下的MSVC编译器，执行以下命令即可：

cl main.cpp classheader.cpp

命令执行时会自动完成两个源文件的编译、以及后续的链接流程，生成可正常运行的程序。

IDE/构建工具编译 #

如果你用Visual Studio、CLion、VS Code搭配CMake/Makefile等构建工具，只需要把classheader.cpp和main.cpp共同添加到项目的源文件列表中，IDE或构建系统会自动识别所有需要编译的源文件，按顺序完成编译和链接步骤，不需要额外手动引入cpp文件。

额外规范提示 #

你现有代码有一个不影响运行但不符合最佳实践的小问题：头文件中尽量不要写using namespace std;，容易造成命名空间污染，建议把类声明里的string替换为std::string，在.cpp源文件中再根据需要使用using声明即可。

内容的提问来源于stack exchange，提问作者Satish Kumar Singh