C语言项目出现undefined reference to function错误，求排查方案

你的问题出在链接阶段，而非编译阶段——编译器能通过头文件找到printPerson的声明，但链接器找不到这个函数的具体实现代码，因为你没把header.c纳入编译流程。

以下是具体排查和解决步骤：

• 手动编译时的正确命令
  用gcc编译时，必须把所有相关的.c源文件都作为参数传入，不能只编译main.c：

  gcc main.c header.c -o myprogram.exe
  

  这条命令会先分别编译main.c和header.c生成目标文件，再将它们链接成完整的可执行程序。如果只执行gcc main.c -o myprogram.exe，就会触发你遇到的链接错误。

• IDE环境的配置检查
  如果用IDE运行，要确保header.c已经被添加到项目的编译列表中：

  • 查看项目文件目录，确认header.c不是未被纳入项目的状态（比如有些IDE里未添加的文件会显示灰色）
  • 部分IDE不会自动识别同一文件夹下的所有.c文件，需要手动将header.c添加到项目中

• 额外验证项
  虽然你的代码里没问题，但这是这类错误的常见诱因，可快速排查：

  • 确认函数声明与实现的拼写、大小写、参数类型完全一致（比如printPerson不能写成PrintPerson，参数类型要和头文件声明匹配）
  • 头文件的#ifndef保护正常，避免出现重复声明或未声明的问题

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