已包含头文件仍出现「Undefined Reference to」错误的原因排查

问题场景 #

编写了一个修改结构体值为100的C程序，包含三个文件：主程序源文件（假设为main.c）、头文件node.h、源文件node.c，代码如下：

主程序代码（main.c） #

#include"node.h"
#include <stdio.h>

int main() {
    simpleObject object1;
    object1.x = 200;
    updateLocation(&object1);
    printf("%d", object1.x);
}

头文件node.h #

typedef struct {
    float x;
    float y;
    float z;
    float mass;
} simpleObject;

void updateLocation(simpleObject* initObject);

源文件node.c #

#include "node.h"

void updateLocation(simpleObject* initObject) {
    initObject->x = 100;
}

遇到两个问题：

1. 编译时提示：undefined reference to updateLocation(simpleObject*)' collect2.exe: error: ld returned 1 exit status`
2. 将node.c中的函数实现移到node.h替换声明后，程序可运行，但输出结果为0。

问题原因与解决方法 #

1. 链接错误（undefined reference）的原因 #

这是链接阶段的错误，不是语法错误。编译时你只单独编译了主程序源文件，没有把node.c一起纳入编译流程，导致链接器找不到updateLocation函数的具体实现代码。

解决方法：
编译时要把所有相关的源文件都传给编译器，比如使用GCC的命令：

gcc main.c node.c -o myprogram

这样链接器会把main.c编译出的目标文件和node.c编译出的目标文件合并，就能找到函数实现了。

2. 移代码到头文件后输出0的原因 #

输出0是因为printf格式符与变量类型不匹配：结构体里的x是float类型，但你用了整数格式符%d来打印，导致内存中的float值被错误解析成整数，最终输出异常。

另外，把函数实现直接放到头文件里还会埋下隐患：如果多个源文件都包含这个头文件，会引发函数重复定义的编译错误，正确的写法还是把函数声明放头文件，实现放源文件，编译时一起链接。

解决方法：
将printf的格式符改成对应float的%f，修改后的printf语句：

printf("%f", object1.x);

或者如果不需要浮点类型，直接把结构体里的x类型改成int。

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