报错中出现 duplicate symbol _xxx 表明链接器发现同一符号在多个目标文件中被定义，违反“一处定义、多处声明”规则；_objc_class_$_xxx 重复多因类实现重复或误引 .m 文件，全局变量重复则常因头文件误定义或未用 extern 声明。

直接看报错里重复的符号名和涉及的 .o 文件，基本能锁定问题源头——不是代码写重了，就是文件被重复编译进去了。

报错里出现 duplicate symbol _xxx 是什么信号

链接器（ld）发现同一个符号（比如函数名、全局变量、类名）在多个目标文件中被定义了。C/C++/Objective-C 不允许“一个符号多处定义”，只允许一处定义、多处声明。

• _OBJC_CLASS_$_MyClass 或 _OBJC_METACLASS_$_MyClass 重复 → 很可能是两个 .m 文件里都实现了同一个类，或者误把 MyClass.m 用 #import 引进了另一个 .m 文件
• _g_counter、_param1 这类带下划线的变量名重复 → 常见于多个 .m 文件里写了同名的全局变量（比如 int g_counter = 0;），而不是用 extern 声明
• 重复出现在 xxx.o 和 yyy.o → 说明这两个源文件都被编译进了最终链接阶段，得查它们是否被重复加入 Build Phases

Xcode 里怎么快速定位重复文件

报错路径里会列出两个冲突的 .o 文件，比如：

duplicate symbol _kDataAuctionId in:
.../RaiseListModel.o
.../SelesOrderModel.o

这说明 RaiseListModel.m 和 SelesOrderModel.m 都定义了 kDataAuctionId。接下来要确认：

• 打开 Xcode 左侧项目导航器，右键点击这两个文件 → “Show in Finder”，看是不是真有两份物理文件（比如复制粘贴没删旧的）
• 选中任一文件 → 右侧 Utilities 面板 → Target Membership → 检查是否勾选了当前 target；如果两个都勾了，且内容雷同，留一个，关掉另一个的勾选
• 在菜单栏选 Product → Show Build Settings，搜索 Other Linker Flags，确认没手动加重复的静态库（比如 -ljson 加了两次）

头文件里不小心写了定义，是最隐蔽的坑

很多人在 .h 文件里直接写：

Clang 22.1.3

Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。

下载

int global_config = 100; // 错！每个 #import 它的 .m 都会生成一份定义

正确做法是分离声明和定义：

• 在 config.h 里写：extern int global_config;
• 在 config.m（或任一且仅一个 .m）里写：int global_config = 100;
• 如果只是常量，优先用 static const NSString *kMyKey = @"key";，static 保证作用域限于本文件，不会导出符号

Objective-C 的 const 字符串也一样：写成 extern NSString *const MyNotificationName; 在 .h，定义放在单个 .m 里。

第三方静态库撞车怎么办

比如工程里既有 libA.a，又手动加了 SBJSON.m，而 libA.a 内部 already 包含 SBJSON.o —— 链接时就会报 duplicate symbol _SBJSONParse。

• 先确认冲突来源：报错路径里出现 libA.a(SBJSON.o) 和 SBJSON.o，说明是静态库和源码并存
• 方案一：删掉工程里的 SBJSON.m（及对应 .h），只用静态库
• 方案二：如果必须用自己改过的 SBJSON.m，那就从 libA.a 中抽掉 SBJSON.o，再重新打包：ar -d libA.a SBJSON.o，然后 lipo -create libA.a libB.a -output libMerged.a
• 千万别让 Xcode 同时把 .m 和包含它的静态库都打进 build phase

最麻烦的是符号名完全一样但实现不同（比如两个版本的 AFNetworking），这时候光删文件不够，得统一依赖管理方式，比如全切到 CocoaPods 或 Swift Package Manager。