C语言typedef struct与头文件、源文件配合使用报错求助

1. 解决“unknown type name 'buffer'”错误 #

C语言区分大小写，你头文件中函数声明的参数使用了小写的buffer，但typedef定义的类型是大写的Buffer，两者不匹配。直接修正声明中的类型名即可，同时要补全头文件中缺失的保护结束标记#endif：

修正后的头文件代码：

#include <stdbool.h>

#ifndef INC_CIRCULAR_BUFFER_H_
#define INC_CIRCULAR_BUFFER_H_

typedef struct Buffer Buffer;

void init_buffer(Buffer *q, uint8_t max_size);

#endif // INC_CIRCULAR_BUFFER_H_

2. 解决“multiple definition of `init_buffer'”错误 #

这个错误是链接阶段发现同一个函数被多次定义导致的，对应两种常见场景及解决方法：

• 场景1：函数仅当前.c文件使用
  在.c文件的函数定义前添加static修饰，限制其作用域为当前编译单元：

  static void init_buffer(Buffer *q, uint8_t max_size){
      // 函数体内容
  }
  

• 场景2：函数需要被其他源文件调用
  确保整个项目中只有一个.c文件包含该函数的定义，其他需要使用该函数的源文件仅通过包含头文件获取声明，不要重复编写函数定义。
• 额外检查：确认编译命令中没有重复添加同一个.c文件，避免重复编译链接。

另外，建议将.c文件中的头文件包含方式从<circular-buffer.h>改为"circular-buffer.h"，编译器会优先在当前目录查找头文件，避免与系统头文件重名冲突。

内容的提问来源于stack exchange，提问作者JULIO JOSE ALIAGA