C++链接器报错：配置正确仍无法找到Log类定义

一、不移类定义到头文件时的报错原因 #

当你把Log类的声明（仅方法签名）放在头文件，方法定义放在单独的.cpp文件里，链接器报未定义错误，基本是这几个问题：

• 实现文件没被纳入编译：比如你把Log的方法写在log.cpp里，但编译时用g++ *.cpp没包含这个文件（比如文件名不匹配、不在当前目录），导致没有生成对应的目标文件，链接器找不到方法的实现。
• 方法定义漏了类限定符：在cpp里写方法时，没加Log::前缀，比如写成void setLevel(int level)而不是void Log::setLevel(int level)，这会让编译器把它当成全局函数，而非Log类的成员，链接器自然找不到类成员的符号。
• 头文件没加包含保护：多个cpp包含头文件时，类被重复声明，编译器生成的符号不一致，链接器无法匹配。

二、移到头文件后仍报错的排查点 #

你说移类定义到头文件后还是报错，大概率是这些情况：

• 旧目标文件没清理：之前编译生成的.o文件还在，里面的符号还是错误的，重新链接时用了旧文件。先执行rm *.o清掉所有旧目标文件，再重新编译。
• 头文件包含重复问题：移到头文件后，没加包含保护（#ifndef ... #endif或#pragma once），多个cpp包含时导致类被重复定义，链接器冲突。
• 方法声明/定义不匹配：比如头文件里声明的是info(const char*)，但cpp里（如果还有残留的定义）写成了info(char*)，参数类型不一致导致符号不匹配。

三、声明/定义分离的正确写法示例 #

如果想保持头文件放声明、cpp放定义的结构，正确写法如下：

log.h（头文件） #

#ifndef LOG_H
#define LOG_H

class Log {
public:
    void setLevel(int level);
    void info(const char* msg);
private:
    int m_level;
};

#endif

log.cpp（实现文件） #

#include "log.h"

void Log::setLevel(int level) {
    m_level = level;
}

void Log::info(const char* msg) {
    // 这里写具体实现逻辑
}

编译命令 #

确保把所有相关cpp都加进去：

g++ main.cpp ep.cpp log.cpp
# 或者分两步编译链接
g++ -c main.cpp ep.cpp log.cpp
g++ main.o ep.o log.o

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