调整文件目录与依赖后Make编译报错：函数重复定义求助

问题根源 #

从链接器错误信息可明确：first/first_pass.o中包含了assembler_utils.c的代码实现，导致该文件里的函数is_valid_symbol_macro_name被编译两次——一次是单独编译assembler_utils/assembler_utils.c生成的目标文件，另一次是通过first_pass.c错误包含assembler_utils.c间接编译进去的，最终链接时出现重复定义冲突。

修复步骤 #

• 检查所有源文件的include语句，禁止包含.c文件
  遍历所有.c文件，找到错误包含其他.c源文件的语句，替换为对应的头文件。比如：

  • 若first/first_pass.c里写了：#include "../assembler_utils/assembler_utils.c"
  • 必须改为：#include "../assembler_utils/assembler_utils.h"
    核心规则：.c文件仅能包含.h头文件，头文件负责声明函数/类型，.c文件负责实现，禁止跨源文件包含代码实现。

• 给所有头文件添加保护机制
  为防止头文件被重复包含引发编译问题，在每个.h文件的开头和结尾添加标准兼容的头文件保护宏：

  // 示例：assembler_utils.h
  #ifndef ASSEMBLER_UTILS_H
  #define ASSEMBLER_UTILS_H
  
  // 原头文件内容（函数声明、类型定义等）
  int is_valid_symbol_macro_name(const char* name);
  
  #endif /* ASSEMBLER_UTILS_H */
  

  也可使用#pragma once（GCC、Clang等主流编译器支持）简化写法，但宏保护是ANSI C标准兼容方案。

• 清理旧目标文件并重新编译
  执行以下命令彻底清理之前编译的目标文件，再重新构建：

  make clean && make
  

• 验证Makefile依赖（可选）
  确认Makefile中每个目标文件的依赖仅包含对应的头文件，比如first/first_pass.o的依赖里只需assembler_utils/assembler_utils.h，无需.c文件，当前你的Makefile这部分是正确的，只需确保源文件的include语句无误即可。

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