C++项目编译报错：ld: 24 duplicate symbols for architecture arm64 问题排查

这个问题我太熟了——你踩了C++头文件使用的经典坑：在头文件里直接定义全局变量，导致每个包含该头文件的源文件都生成了一份变量副本，链接时直接冲突炸锅。

问题根源 #

当你在define.h里写：

int Way;
int *variable;

这可不是简单的变量声明，而是实际的定义操作。C++编译器处理每个.cpp文件时，只要包含了这个头文件，就会在对应的目标文件（比如main.cpp.o、fileparser.cpp.o）里为这两个变量分配内存、创建独立的实体。等到链接阶段，链接器发现多个目标文件里都有同名的全局符号（_Way、_variable），自然就会抛出duplicate symbol错误。

解决方案 #

要彻底解决这个问题，核心是把变量声明和定义严格分开：

1. 在头文件里仅做变量声明
   修改define.h，用extern关键字标记变量，告诉编译器“这个变量在其他地方已经定义了，我只是在这里声明它的存在，不用分配内存”：

   // 头文件保护（可选但强烈推荐，防止重复包含引发其他编译问题）
   #ifndef DEFINE_H
   #define DEFINE_H
   
   // 仅声明变量，不分配内存
   extern int Way;
   extern int *variable;
   
   // 你的其他函数声明...
   
   #endif // DEFINE_H
   

2. 在单个源文件里完成变量定义
   找一个单独的源文件（比如main.cpp，或者专门新建一个globals.cpp），在这里实际定义这些变量，确保整个项目里只有一份实体：

   #include "define.h"
   
   // 实际定义全局变量，分配内存
   int Way;
   int *variable;
   
   int main() {
       // 你的业务代码...
   }
   

额外建议 #

• 尽量减少全局变量的使用：全局变量会让代码耦合度变高，调试和维护都更麻烦。如果可以，优先通过类成员变量、函数参数传递等方式替代。
• 始终给头文件加保护：虽然这不是解决当前重复符号的直接原因，但能避免头文件被多次包含导致的编译错误，是C++开发的基本好习惯。

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