C语言开发：已包含头文件中声明的变量无法被识别问题咨询

最近碰到个糟心的问题：我有三个文件test.c、test.h和use.c，明明头文件test.h里已经声明了函数和类型，但编译时其他文件就是识别不了这些声明。先把我的代码片段贴出来：

代码片段 #

test.h #

#pragma once
#define unused __attribute__((unused))
typedef int cmd_fun_t(struct tokens *tokens);
typedef struct fun_desc {
    cmd_fun_t *fun;
    char *cmd;
    char *doc;
} fun_desc_t;
int cmd_exit(struct tokens *tokens);
int cmd_help(struct tokens *tokens);
int cmd_pwd(struct tokens *tokens);
int cmd_cd(struct tokens *tokens);

test.c #

#include <ctype.h>
#include <errno.h>
#include <stdbool.h>
// 后续实现代码省略

一步步排查&解决 #

这种问题90%都是包含方式或编译流程的锅，咱们挨个排查：

• 确认头文件被正确包含
  不管是test.c还是use.c，一定要在代码开头加上#include "test.h"——别写错文件名！Linux/macOS下大小写敏感，比如Test.h和test.h是两个文件，这点很容易踩坑。如果头文件不在当前目录，要用#include "../path/to/test.h"或者编译时加-I参数指定路径。

• 检查编译命令是否正确
  如果你只编译use.c而没带上test.c，编译器找不到函数的实现肯定报错。正确的编译方式要把所有相关源文件都带上：

  # 直接编译链接
  gcc test.c use.c -o my_program
  # 或者分步编译成目标文件再链接（适合大项目）
  gcc -c test.c -o test.o
  gcc -c use.c -o use.o
  gcc test.o use.o -o my_program
  

• 验证声明和实现的签名完全匹配
  比如test.c里实现cmd_exit的时候，函数的返回值、参数类型必须和test.h里的声明一模一样。举个反例：如果头文件里是int cmd_exit(struct tokens *tokens)，但实现写成了void cmd_exit(struct tokens *tokens)，编译器会认为这是两个完全不同的函数，自然找不到匹配的声明。

• 头文件保护的兼容性（可选）
  虽然你用了#pragma once来防止重复包含，但有些老编译器可能不支持。如果遇到重复定义的错误，可以换成更通用的头文件保护宏：

  #ifndef TEST_H
  #define TEST_H
  // 原来的test.h内容
  #endif // TEST_H
  

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