如何修复XCode/Mac下汇编链接的"ld:32位RIP相对引用超出范围"错误

问题根源 #

你遇到的32-bit RIP relative reference out of range错误，本质是macOS x86_64默认的小代码模型（Small Code Model）限制：RIP相对寻址仅支持±2GB的范围。而你用.set定义的_kEmbeddedDataPack_sz是绝对符号，其值是数据的大小（约40MB），但C++代码引用时，编译器会错误地将其当作内存地址尝试RIP相对访问，导致链接器解析时出现地址范围溢出。

可行解决方案（保留汇编方案，适配多平台Clang） #

方案1：在C++代码中直接计算数据大小（最通用） #

无需修改现有汇编代码，只保留_kEmbeddedDataPack和_kEmbeddedDataPack_end两个边界符号，在C++代码中通过地址差值计算大小：

extern "C" const unsigned char kEmbeddedDataPack[];
extern "C" const unsigned char kEmbeddedDataPack_end[];

// 编译/链接时直接计算常量，无运行时开销
const size_t kEmbeddedDataPack_sz = 
    reinterpret_cast<uintptr_t>(kEmbeddedDataPack_end) - 
    reinterpret_cast<uintptr_t>(kEmbeddedDataPack);

这种方式彻底规避了单独的size符号，所有平台（arm64/x86_64等）的Clang都能正确处理，且没有额外的内存开销。

方案2：修改汇编代码，将size存储为只读段常量 #

把原来的.set定义改为在只读数据段中存储8字节的大小值，确保符号是合法的内存地址，且处于RIP相对寻址范围内：

.data
.balign 64
.global _kEmbeddedDataPack
_kEmbeddedDataPack:
.incbin "mydata.bin"
.global _kEmbeddedDataPack_end
_kEmbeddedDataPack_end:

; 将size存储在__TEXT/__const段（与代码段同区域，RIP寻址可达）
.section __TEXT,__const
.global _kEmbeddedDataPack_sz
_kEmbeddedDataPack_sz:
.quad _kEmbeddedDataPack_end - _kEmbeddedDataPack  ; 8字节无符号整数存储大小

C++代码中仍用extern "C" const size_t kEmbeddedDataPack_sz;引用即可，链接器会正确解析这个只读段中的符号，不会触发范围错误。

为什么之前的尝试无效？ #

• -fno-pic/-fno-pie：关闭PIE后，macOS x86_64链接器仍会对符号使用RIP相对寻址，而.set定义的绝对符号本身不是合法的内存地址，因此无法解决问题。
• -mcmodel=large：大代码模型会改变寻址方式，但会引入其他兼容性问题（比如部分指令生成变化），不适合多平台适配场景。

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