本地编译C++代码时GCC无法找到函数定义的问题求助

我将C++代码拆分为.hpp头文件和.cpp源文件后，在线编译器可正常编译运行，但本地执行g++ main.cpp -o main命令时，出现undefined reference to Edge::Galaxy::Galaxy::GalaxyFunction()链接错误。相关代码及错误信息如下：

galaxy.hpp

#pragma once
#include <vector>
namespace Edge
{
    namespace Galaxy
    {

        class Galaxy
        {
        public:
            std::vector<int> GalaxyFunction();
        };
    }
}

galaxy.cpp

#include "galaxy.hpp"
#include <vector>
namespace Edge
{
    namespace Galaxy
    {

        std::vector<int> Galaxy::GalaxyFunction()
        {
            std::vector<int> d = {1, 23, 5};
            return d;
        }

    }
}

main.cpp

#include "galaxy.hpp"
#include "iostream"
int main()
{

    Edge::Galaxy::Galaxy ser;
    auto a = ser.GalaxyFunction();
    std::cout << a.size();

    return 0;
}

错误信息：

PS A:\C++Pr\sometype> cd "a:\C++Pr\sometype" ; if ($?) { g++ main.cpp -o main } ; if ($?) { .\main }
c:/program files (x86)/mingw-w64/i686-8.1.0-posix-dwarf-rt_v6-rev0/mingw32/bin/../lib/gcc/x86_64-w64-mingw32/11.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: C:\Users\senor\AppData\Local\Temp\ccjwwRcg.o:main.cpp:(.text+0x1c): undefined reference to `Edge::Galaxy::Galaxy::GalaxyFunction()'
collect2.exe: error: ld returned 1 exit status

错误原因 #

• 核心问题是链接阶段缺失函数实现代码：执行g++ main.cpp -o main时，仅编译了main.cpp，但GalaxyFunction()的具体实现写在galaxy.cpp中，这个文件既没被编译，也没参与链接，导致链接器找不到该函数的二进制实现，抛出"undefined reference"错误。
• 在线编译器会自动检测目录下所有相关源文件并统一编译，因此不会出现该问题。

解决方法 #

方法1：一次性编译所有源文件 #

直接将所有.cpp文件作为参数传给g++，让编译器同时完成编译和链接：

g++ main.cpp galaxy.cpp -o main

执行完上述命令后，运行.\main（Windows系统）或./main（Linux/macOS系统）即可正常启动程序。

方法2：分步编译为目标文件再链接 #

若源文件数量较多，可先将每个.cpp编译为独立的目标文件（.o格式），再统一链接生成可执行文件：

1. 编译main.cpp为目标文件：

g++ -c main.cpp -o main.o

2. 编译galaxy.cpp为目标文件：

g++ -c galaxy.cpp -o galaxy.o

3. 链接所有目标文件生成可执行文件：

g++ main.o galaxy.o -o main

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