C语言导入头文件未关联源文件致addNum undefined reference错误求助

undefined reference to 'addNum' 属于链接阶段的错误，和头文件引入逻辑无关：

• 头文件仅承担向编译器提供函数声明的作用，帮助编译器校验函数调用的参数类型是否匹配，不会把函数的具体实现打包进最终可执行程序
• 出现这个报错的核心原因是：当前编译流程仅单独处理了Main.c，没有把存放addNum实现的testFunction.c纳入编译范围，导致链接器在拼接最终程序时，找不到addNum对应的实现地址，直接抛出异常。

命令行手动编译场景 #

仅编译单文件的错误命令：
gcc Main.c -o main

正确编译命令，需要把所有业务源文件显式传入编译参数：
gcc Main.c testFunction.c -o main

执行这个命令后，编译器会先把两个.c文件分别编译成二进制目标文件，再将所有目标文件拼接链接为最终可执行程序，就能正常解析addNum的实现地址。

图形化IDE开发场景 #

逐一核对以下排查点：

• 确认testFunction.c已被手动加入当前项目的编译列表：很多IDE允许文件物理存放在项目文件夹下，但如果没手动在项目树里添加该文件，会直接跳过对它的编译流程
• 检查自定义编译配置：如果是VS Code、Dev-C++这类需要手动写编译规则的工具，确认编译指令的参数里没有遗漏testFunction.c
• 排查路径问题：如果项目全路径包含中文、空格或特殊符号，部分版本的IDE会出现源文件扫描失败的问题，把项目移动到纯英文无特殊字符的路径下即可解决

• 不要误以为#include "testFunction.h"会自动关联同目录下的同名.c文件：include操作本质是把指定头文件的文本内容插入到当前代码位置，和同目录下的其他源文件没有任何绑定关系
• 不要为了快速消错，直接把addNum的函数实现写在testFunction.h里：这种写法虽然短期可以编译通过，但如果后续有其他源文件引入这个头文件，会触发multiple definition of 'addNum'的新报错

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