C++项目使用Makefile编译出现函数多重定义、main未定义链接错误

两个报错不是独立故障，存在直接的触发关联：

• 首先触发的是hh类构造函数、成员函数多重定义错误：链接器扫描完所有翻译单元生成的符号表后，发现同一个函数在多个目标文件中存在非inline的重复定义，触发ld规则校验。
• 后续的main符号未定义报错并非独立问题：ld在处理多重定义错误后会提前中断符号解析流程，不会继续扫描链接列表里排在冲突目标文件之后的main.o，就会连带报找不到main符号，并非main对应的目标文件完全没有生成。

结合你当前的最简测试代码配置，大概率是两类问题叠加导致：

代码层面的符号重复 #

• 没有做头文件隔离，把hh类的成员函数实现直接写在了hh.h中，且没有加inline修饰：当main.cpp和hh.cpp都包含这个头文件时，两个翻译单元会各自生成一份完整的函数符号定义，链接阶段就会触发多重定义报错。
• 头文件没有加防重复包含的保护宏或者#pragma once，导致同一个头文件的内容被重复引入，进一步放大符号重复的问题。

Makefile规则的逻辑漏洞 #

• 源文件匹配规则存在重叠：比如同时写了src/*.cpp和递归的全路径匹配规则，导致main.cpp被两次识别为编译目标，生成的目标文件路径冲突被互相覆盖，最终链接列表里缺失main对应的符号。
• 并行编译模式（make --jobs=9）下没有提前创建目标文件存放的子目录：当src下存在二级嵌套路径的cpp文件时，对应的dist/obj下的子目录没有在编译任务启动前创建，会导致部分目标文件编译失败、没有生成完整的符号表。
• 链接规则的输入列表收集不全：没有用自动推导的方式把所有编译生成的.o文件全部加入链接入参，手动列举链接文件时漏加了main对应的目标文件。

1. 调整代码结构保证符号定义唯一：
   • 头文件中仅保留类声明、函数原型，所有非模板类的成员函数实现必须放在对应的.cpp文件中
   • 头文件顶部添加#pragma once做重复包含保护
   • 如需在头文件中实现函数，必须给函数添加inline关键字，允许编译器合并跨翻译单元的相同定义
2. 修正Makefile的核心规则：
   • 源文件收集去重：用单条递归规则匹配所有cpp文件，避免重复路径匹配，例如
     SRC := $(wildcard src/*.cpp src/*/*.cpp)
   • 自动推导目标文件列表：将所有源文件路径映射为dist/obj下的对应.o文件，例如
     OBJ := $(patsubst src/%.cpp, dist/obj/%.o, $(SRC))
   • 增加并行编译兼容逻辑：在编译规则中添加目标文件所在目录的自动创建逻辑，避免编译时目录不存在的报错
   • 链接阶段直接使用自动收集的完整OBJ列表作为编译器入参，不要手动拆分列举目标文件
3. 复现验证：完成修正后先单线程执行make build排查规则错误，再开启多线程编译验证并行场景的稳定性。

内容的提问来源于stack exchange，提问作者Pavel B.