如何正确编写C头文件并解决函数链接未定义引用错误？

核心错误点 #

• 未链接函数实现文件
  GCC报"undefined reference to 'add'"的根本原因是编译时仅处理了main.c，但没有将包含add函数实际实现的header.c纳入编译流程。头文件只是函数声明，不包含执行代码，必须把实现文件和主文件一起编译链接。

• 函数名拼写错误
  main.c中调用的print是笔误，标准输出函数应为printf，缺少末尾的f会导致额外编译错误。

正确编译步骤 #

你可以通过以下两种方式完成编译：

1. 一次性编译所有源文件：

gcc main.c header.c -o calc

执行生成的可执行文件./calc即可得到输出结果5。

2. 分步编译为目标文件再链接（适合大型项目）：

# 编译main.c为目标文件
gcc -c main.c -o main.o
# 编译header.c为目标文件
gcc -c header.c -o header.o
# 链接所有目标文件生成可执行文件
gcc main.o header.o -o calc

关于extern关键字的说明 #

你在头文件中用extern声明函数是合法的，但C语言中函数声明默认带有extern属性，写不写对功能没有影响。这种头文件与源文件分离的写法核心作用是代码模块化与接口隔离，和减小二进制体积没有直接关联——若想缩小最终程序体积，可添加编译优化选项（如-O2）。

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