将Sphere类setColor()实现移至.cpp后出现链接错误，求解决

问题现象 #

之前在Sphere类的.h文件内实现setColor()可正常编译，将函数定义移至sphere.cpp后出现链接错误，编译命令及错误信息如下：

Starting build...
cmd /c chcp 65001>nul && g++.exe -std=c++17 -g -I include -L lib src\* -o bin\helloworld.exe -lfreeglut -lopengl32 -lglu32
C:/msys64/ucrt64/bin/../lib/gcc/x86_64-w64-mingw32/13.2.0/../../../../x86_64-w64-mingw32/bin/ld.exe: C:\Users\sdelgado\AppData\Local\Temp\ccIOwL6S.o: in function `main':
C:\msys64\home\sdelgado\helloworld\src\main.cpp:55:(.text+0x1b3): undefined reference to `Sphere::setColor(unsigned char, unsigned char, unsigned char)'
collect2.exe: error: ld returned 1 exit status

相关代码文件：

sphere.h #

class Sphere
{
public:
    float radio;
    float x;
    float y;
    unsigned char red;
    unsigned char green;
    unsigned char blue;
    void setColor( unsigned char r, unsigned char g, unsigned char b);
};

sphere.cpp #

#include "sphere.h"
void Sphere::setColor(unsigned char r,unsigned char g, unsigned char b)
{
    red=r;
    green=g;
    blue=b;
}

main.cpp #

#include "sphere.h"
Sphere sphere;
main()
{
[...]
sphere.setColor(200,0,0); 
}

问题原因 #

并非遗漏头文件引用，而是编译命令未正确将sphere.cpp纳入编译流程。你使用的src\*在Windows命令行环境中，无法被g++正确解析为所有源文件，导致sphere.cpp未被编译为目标文件，链接阶段找不到Sphere::setColor的定义。

解决方法 #

修改编译命令，明确指定所有需要编译的源文件，或使用更可靠的通配方式：

1. 直接列出源文件：

g++.exe -std=c++17 -g -I include -L lib src/main.cpp src/sphere.cpp -o bin/helloworld.exe -lfreeglut -lopengl32 -lglu32

2. 若使用MSYS2/bash等类Unix环境，可通配所有cpp文件：

g++.exe -std=c++17 -g -I include -L lib src/*.cpp -o bin/helloworld.exe -lfreeglut -lopengl32 -lglu32

注：Windows CMD的通配符处理逻辑与类Unix Shell不同，src\*可能会展开为目录下所有文件（包括非cpp文件），或无法正确传递给g++，最终导致源文件遗漏。

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