拆分命名空间到cpp/hpp文件时出现Undefined symbols错误求助

链接错误的核心是友元operator<<的声明与定义作用域不匹配：

• 在huffman.hpp中，EncodingMap类声明了Huffman::operator<<作为友元，但huffman.cpp里直接在类内部定义该函数时，这个函数会被视为全局作用域函数，而非Huffman命名空间下的成员。
• 编译main.cpp时，编译器根据头文件声明期望链接到Huffman::operator<<符号，但实际huffman.cpp生成的是全局作用域的同名函数，导致链接器找不到目标符号。

提供两种可行的修复方式：

方案一：将友元函数移到命名空间下单独定义 #

修改huffman.hpp的EncodingMap类，仅保留友元声明：

// huffman.hpp
class EncodingMap
{
public:
    EncodingMap(const std::string &text);

    friend std::ostream &operator<<(std::ostream &os, const EncodingMap &map);

    const std::string &operator[](char symbol);
};

在huffman.cpp的Huffman命名空间下单独定义operator<<（同时修正原代码中直接用std::cout的错误，改用传入的os参数）：

// huffman.cpp
namespace Huffman
{
    // ... TreeNode类定义及其他代码 ...

    class EncodingMap
    {
    private:
        std::unordered_map<char, std::string> map;
        void build(std::shared_ptr<TreeNode> node, std::string code);

    public:
        EncodingMap(const std::string &text);
        const std::string &operator[](char symbol);
    };

    // 单独定义友元operator<<
    std::ostream &operator<<(std::ostream &os, const EncodingMap &map)
    {
        for (const auto &[key, value] : map.map)
        {
            os << key << "=" << value << std::endl;
        }
        return os;
    }

    // ... encode函数及其他成员函数实现 ...
}

方案二：将友元函数定义移到头文件并加inline关键字 #

如果希望保留类内定义的写法，可将operator<<的定义移到huffman.hpp中，并添加inline关键字，确保各编译单元的定义一致：

// huffman.hpp
class EncodingMap
{
private:
    std::unordered_map<char, std::string> map;
    void build(std::shared_ptr<TreeNode> node, std::string code);

public:
    EncodingMap(const std::string &text);

    friend inline std::ostream &operator<<(std::ostream &os, const EncodingMap &map)
    {
        for (const auto &[key, value] : map.map)
        {
            os << key << "=" << value << std::endl;
        }
        return os;
    }

    const std::string &operator[](char symbol);
};

同时需在huffman.cpp中实现build等私有成员函数，确保类的完整性。

使用原编译命令重新编译：

g++ ./src/main.cpp ./src/huffman.cpp -std=c++17

编译运行后，链接错误会消失，程序可正常输出编码结果。

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