如何避免头文件声明不完整类型后typedef重定义编译错误？

错误原因 #

你在头文件中的写法引发了类型声明冲突：

• 头文件里仅声明了结构体标签 struct siginfo_t;，但直接使用了未定义的类型名 siginfo_t* 作为函数参数。
• 系统头文件 <signal.h> 中通过 typedef struct siginfo_t { /* */ } siginfo_t; 将结构体标签 siginfo_t 重命名为类型名 siginfo_t，此时编译器会认为你试图将两种不同的类型（struct siginfo_t 和未正确声明的 siginfo_t）重定义，从而抛出错误。

解决方案 #

方案一：使用结构体标签作为参数类型 #

修改头文件，直接用 struct siginfo_t* 作为函数参数类型，避免依赖未定义的typedef名：

// a.h
struct siginfo_t;
void foo(struct siginfo_t*);

源文件中可以正常使用 siginfo_t*，因为 <signal.h> 的typedef会让 siginfo_t 和 struct siginfo_t 等价：

// a.cpp
#include "a.h"
#include <signal.h> 
void foo(siginfo_t* x) { /* implementation */ }

方案二：提前声明typedef与系统保持一致 #

在头文件中先声明typedef，匹配系统头文件的定义逻辑，让编译器识别这是同一类型的前置声明：

// a.h
typedef struct siginfo_t siginfo_t;
void foo(siginfo_t*);

源文件引入 <signal.h> 时，系统的typedef会补充结构体的具体定义，这种前置声明+后续定义的方式符合C++语法规则，不会触发重定义错误。

内容的提问来源于stack exchange，提问作者Саша Новожилов