编译C++多文件遇函数多重定义错误，需配置头文件路径

问题现象 #

尝试通过Makefile将多份代码编译为单个可执行文件，先编译生成bin目录下的目标文件再链接，执行make后出现多重定义错误，同时无法直接使用#include "something.hpp"（需指定相对路径）。错误输出如下：

./lib/a.cpp main.cpp
g++ -Wall -c lib/a.cpp -o bin/a.o
./lib/a.cpp main.cpp
g++ -Wall -c lib/a.cpp -o bin/main.o
Linking...
g++ -Wall -o main ./bin/a.o ./bin/main.o
/usr/bin/ld: ./bin/main.o: in function `Test::Test()':
a.cpp:(.text+0x0): multiple definition of `Test::Test()'; ./bin/a.o:a.cpp:(.text+0x0): first defined here
/usr/bin/ld: ./bin/main.o: in function `Test::Test()':
a.cpp:(.text+0x0): multiple definition of `Test::Test()'; ./bin/a.o:a.cpp:(.text+0x0): first defined here
/usr/bin/ld: ./bin/main.o: in function `Test::Print()':
a.cpp:(.text+0x10): multiple definition of `Test::Print()'; ./bin/a.o:a.cpp:(.text+0x10): first defined here
/usr/bin/ld: /usr/lib/gcc/x86_64-linux-gnu/13/../../../x86_64-linux-gnu/Scrt1.o: in function `_start':
(.text+0x1b): undefined reference to `main'
collect2: error: ld returned 1 exit status
make: *** [Makefile:15: main] Error 1

原代码文件 #

main.cpp #

#include "a.hpp"

int main() {
    Test test;
    return 0;
}

lib/a.cpp（注：原文件标注为bin/a.cpp，与Makefile中DIR_LIB = ./lib配置不符，需移至lib目录） #

#include "a.hpp"

#include <iostream>

Test::Test() {

}

void Test::Print() {
    std::cout << "Hello World!" << std::endl;
}

a.hpp #

#ifndef TEST_H
#define TEST_H

class Test {
public:
    Test();
    static void Print();
};

#endif // TEST_H  // 原代码写为BUTTON_MANAGER_H，此处修正为一致的宏名

原Makefile #

DIR_BIN = ./bin
CXX = g++
CXXFLAGS = -Wall

DIR_LIB = ./lib

SRC= $(wildcard $(DIR_LIB)/*.cpp) main.cpp
OBJ= $(patsubst %.cpp,$(DIR_BIN)/%.o,$(notdir $(SRC)))
TARGET = main

all: $(TARGET)

$(TARGET): $(OBJ)
    @echo "Linking..."
    $(CXX) $(CXXFLAGS) -o $(TARGET) $(OBJ)

$(DIR_BIN)/%.o: $(SRC)
    @echo $(SRC)
    $(CXX) $(CXXFLAGS) -c $< -o $@

clean:
    rm -f $(DIR_BIN)/*.o
    rm -f $(TARGET)

问题原因 #

1. Makefile编译规则错误：
   原规则$(DIR_BIN)/%.o: $(SRC)表示所有bin目录下的.o文件都依赖整个SRC集合（lib/a.cpp和main.cpp），编译时$<会取第一个依赖文件lib/a.cpp，导致bin/main.o实际是由a.cpp编译生成的，而非main.cpp。链接时，bin/a.o和bin/main.o都包含Test类的实现，因此出现多重定义错误；同时真正的main函数未被编译，导致undefined reference to main。

2. 头文件搜索路径未配置：
   默认情况下编译器只会在当前目录和系统头文件目录搜索，若头文件不在当前目录，需要通过-I参数指定搜索路径，才能直接使用#include "a.hpp"。

修复方案 #

1. 修正Makefile编译规则 #

调整目标文件的依赖规则，让每个.o文件对应正确的源文件：

• 对于lib目录下的.cpp，生成bin/%.o依赖lib/%.cpp
• 对于main.cpp，生成bin/main.o依赖main.cpp

2. 添加头文件搜索路径 #

在CXXFLAGS中加入-I./（假设头文件在当前根目录），若头文件在其他目录，替换为对应路径即可。

修复后的Makefile #

DIR_BIN = ./bin
CXX = g++
# 添加头文件搜索路径-I./，保留-Wall参数
CXXFLAGS = -Wall -I./

DIR_LIB = ./lib

# 收集所有源文件
SRC = $(wildcard $(DIR_LIB)/*.cpp) main.cpp
# 生成对应的目标文件路径
OBJ = $(patsubst %.cpp,$(DIR_BIN)/%.o,$(notdir $(SRC)))
TARGET = main

# 确保bin目录存在，避免编译时找不到目录
$(DIR_BIN):
    mkdir -p $(DIR_BIN)

all: $(DIR_BIN) $(TARGET)

$(TARGET): $(OBJ)
    @echo "Linking..."
    $(CXX) $(CXXFLAGS) -o $(TARGET) $(OBJ)

# 处理lib目录下的源文件，生成bin目录下的目标文件
$(DIR_BIN)/%.o: $(DIR_LIB)/%.cpp
    $(CXX) $(CXXFLAGS) -c $< -o $@

# 处理main.cpp，生成bin/main.o
$(DIR_BIN)/main.o: main.cpp
    $(CXX) $(CXXFLAGS) -c $< -o $@

clean:
    rm -rf $(DIR_BIN)
    rm -f $(TARGET)

3. 其他细节修正 #

• 将a.cpp从bin目录移至lib目录，与Makefile中DIR_LIB配置一致
• 修正头文件中的宏定义结尾：#endif // TEST_H（原代码写为BUTTON_MANAGER_H，与开头的TEST_H不匹配，规范上应保持一致）

验证 #

执行make后，会正确编译lib/a.cpp为bin/a.o，main.cpp为bin/main.o，链接生成main可执行文件，无报错；同时可以直接使用#include "a.hpp"无需指定相对路径。

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