iOS-Duplicate Symbol链接错的原因总结和解决方法

淡淡的烟草味﹌ 2023-10-17 01:23 19阅读 0赞

duplicate symbol是一种常见的链接错误，不像编译错误那样可以直接定位到问题的所在。但是经过一段时间的总结，发现这种错误总是有一些规律可以找的。  
例如，我们有如下的最简单的两个类代码：

//  ClassA.h
    #import <Foundation/Foundation.h>
    @interface ClassA : NSObject
    @end
    
    //  ClassA.m
    #import "ClassA.h"
    @implementation ClassA
    @end

//  ClassB.h
    #import <Foundation/Foundation.h>
    @interface ClassB : NSObject
    @end

//  ClassB.m
    #import "ClassB.h”
    @implementation ClassB
    @end

编译后出现的错误信息如下：

duplicate symbol _OBJC_METACLASS_$_ClassA in:   
     /Users/dajie/Library/Developer/Xcode/DerivedData/linkTest-cpjaaatiyqpvxcbzfzpklcbqrgqg/Build/Intermediates/linkTest.build/Debug-iphonesimulator/linkTest.build/Objects-normal/i386/ClassA.o   
     /Users/dajie/Library/Developer/Xcode/DerivedData/linkTest-cpjaaatiyqpvxcbzfzpklcbqrgqg/Build/Intermediates/linkTest.build/Debug-iphonesimulator/linkTest.build/Objects-normal/i386/ClassB.o
    duplicate symbol _OBJC_CLASS_$_ClassA in:    /Users/dajie/Library/Developer/Xcode/DerivedData/linkTest-cpjaaatiyqpvxcbzfzpklcbqrgqg/Build/Intermediates/linkTest.build/Debug-iphonesimulator/linkTest.build/Objects-normal/i386/ClassA.o    
    /Users/dajie/Library/Developer/Xcode/DerivedData/linkTest-cpjaaatiyqpvxcbzfzpklcbqrgqg/Build/Intermediates/linkTest.build/Debug-iphonesimulator/linkTest.build/Objects-normal/i386/ClassB.old: 2 
    duplicate symbols for architecture i386clang: error: linker command failed with exit code 1 (use -v to see invocation)

从上面出现问题的地方，我们应该能推测出是ClassA这个类出了问题。如果这个类是我们自己写的，就容易办一些。

可以考虑以下原因：  
1.引入头文件时，由于疏忽，误引入.m文件。这种一般仔细检查一下出现问题的类的源文件就能发现。  
例：ClassB.m 文件修改成下面这样

#import "ClassB.h>"
    #import "ClassA.m” // 这句话有问题
    @implementation ClassB
    @end

2.同一个类，实现两次，即有两个@implementation 。这种一般会有一个警告，也比较容易发现。  
例：ClassB.m文件修改成下面这样：

//  ClassB.m
    #import "ClassB.h”
    @implementation ClassB
    @end
    @implementation ClassA
    @end

3.工程文件，同一个类文件被引入了两次，引起这种错误的原因大概有两种：一是多人协作开发时，导致project文件合并冲突；二是同名文件不在同一目录下，添加到工程时造成重复添加。 这种一般在文件视图，用名字过滤器检查一下就发现了。

4. Targets的Build Phase设置项里，查看Complie Sources这一项，看看出现问题的类是不是有重复的，用文件名过滤也比较容易发现。这种问题一般也是多人协作开发时，project文件冲突导致的。发现这种问题，只要删除就可以了。不过在我解决问题过程中，删除其中一个文件时，重复文件会自动全部删除，所以还需要单独添加一下。

5.如果我们的工程中引用了第三方的库，而恰好第三方的库里面有一个ClassA，也会出现这种问题。如果不能修改第三方的库代码，只能修改我信自己的代码了。

另可参考博主这种类型的其他文章

[duplicate symbol重复导入某一文件][duplicate symbol]

[编译报错duplicate symbol \_OBJC\_IVAR][duplicate symbol _OBJC_IVAR]

[duplicate symbol]: http://blog.csdn.net/minggeqingchun/article/details/50878915
[duplicate symbol _OBJC_IVAR]: http://blog.csdn.net/minggeqingchun/article/details/51694402