为何无法引用.h文件声明函数的实现？C语言多文件编译报错

解决方法 #

1. 直接编译所有关联源文件 #

修改VS Code中Run Code执行的命令，把Get_para.c也加入编译列表：

if ($?) { gcc test.c Get_para.c -o test -lm } ; if ($?) { .\test }

注：-lm参数是因为Get_para.c中用到了math.h的函数，需要链接系统数学库，避免后续出现数学函数的链接错误。

2. 预编译目标文件再链接（适合多文件项目复用） #

先单独编译Get_para.c生成目标文件：

gcc -c Get_para.c -o Get_para.o -lm

之后编译test.c时直接链接这个目标文件：

gcc test.c Get_para.o -o test -lm

如果想更方便地复用Get_para的代码，可以把目标文件打包成静态库：

ar rcs libgetpara.a Get_para.o

后续编译只需链接这个库即可：

gcc test.c -o test -lgetpara -lm -L.

-L.表示告诉编译器在当前目录查找库文件。

相关C语言核心知识 #

头文件与源文件的分工 #

• 头文件（.h）：仅做声明，用来告诉编译器变量的类型、函数的签名（返回值+参数），相当于公共接口说明，不包含具体实现代码。你引入Get_para.h只是让编译器知道"有这些变量和函数存在"，但不知道它们的代码在哪里。
• 源文件（.c）：做定义与实现，包含变量的初始化、函数的具体逻辑，是实际可执行代码的载体。

extern关键字的作用 #

extern是用来声明"该变量/函数的定义在其他源文件中"，它仅起到告知编译器的作用，不会提供任何实际代码，链接阶段仍需找到对应的定义文件。

编译与链接的不同阶段 #

• 编译阶段：将单个.c文件转换为目标文件（.o），仅检查语法正确性、头文件引用是否合法、声明是否存在，不校验定义是否存在。
• 链接阶段：将所有用到的目标文件、库文件合并为可执行程序，此时会检查所有声明过的变量/函数是否有对应的定义，找不到就会抛出"undefined reference"错误——这正是你遇到的问题：只编译了test.c，链接器找不到calParameter()和dSemiMajorAxis在Get_para.c中的定义。

为什么仅引入头文件不够？ #

头文件没有实际代码，只是声明信息。要使用Get_para.c中的实现，必须让编译器把Get_para.c的编译结果加入链接过程，否则链接器无法找到对应的代码。

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