如何让链接器从Unity Build生成的库目标文件中提取部分代码链接？

我明白你现在遇到的问题：用Unity Build把多个C文件合并成大翻译单元编译成库后，碰到了两个头疼的场景——要么是程序自己编译了某个文件的另一个版本，和库中的符号冲突，只想用库中特定文件的代码；要么是只想用库中某部分代码，不想被其他文件的未解析依赖拖后腿。下面结合不同平台的工具链，给你梳理可行的解决方案：

一、核心结论：无法直接拆分Unity目标文件，但有间接解决办法 #

首先明确：几乎没有主流链接器支持直接从Unity编译出的单个目标文件里，拆分回原单个C文件的独立目标文件。因为Unity Build把多个C文件合并成一个翻译单元编译后，编译器会做大量优化（比如函数内联、常量合并），原单个文件的代码边界已经完全消失，没法准确拆分。不过我们可以通过其他方式绕开问题：

1. 用函数级链接优化让链接器自动“丢弃”无用代码 #

很多编译器支持将每个函数/数据放到独立的段中，链接时可以只保留被引用到的部分，自动忽略未使用的代码和其依赖：

• MacOS/Linux（Clang/GCC）：
  针对你给出的示例，修改编译命令，启用段拆分和垃圾回收：

  # 编译Unity单元时，将每个函数/数据放到独立段
  clang -c -ffunction-sections -fdata-sections single_translation_unit.c -o single_translation_unit.o
  libtool -static single_translation_unit.o -o library2.lib
  clang -c main.c -o main2.o
  # 链接时启用垃圾回收，移除未引用的段
  clang main2.o library2.lib -Wl,--gc-sections -o program2.out
  

  这样链接器会发现main只用到了file1_a，自动忽略file2.c里的代码和它对file3_a的未解析引用，顺利生成可执行文件。

• Windows（Visual Studio）：
  启用函数级链接和未引用代码移除：

  # 编译Unity单元时启用函数级链接
  cl /c /Gy single_translation_unit.c /Fo single_translation_unit.obj
  lib single_translation_unit.obj /OUT:library2.lib
  cl main.c library2.lib /LINK /OPT:REF
  

  /Gy让每个函数成为独立的链接单元，/OPT:REF让链接器移除未被引用的函数，这样就能只提取你需要的file2.c代码，避开符号冲突或无用依赖。

• ARM裸机（ARM ADS 1.2）：
  这个老工具链也支持类似的段拆分功能，用armcc的-split_sections和armlink的--remove选项：

  armcc -c -split_sections single_translation_unit.c -o single_translation_unit.o
  armlink -lib single_translation_unit.o -o library2.lib
  armcc -c main.c -o main2.o
  armlink main2.o library2.lib --remove -o program2.elf
  

2. 调整Unity Build的分组策略（最稳妥的老工具链方案） #

如果工具链不支持函数级优化（比如某些极端老版本），可以主动拆分Unity单元的分组：

• 把可能被单独引用的文件（比如file1.c、file2.c）分到独立的小Unity单元里，比如tu_file1.c只包含file1.c，tu_file2_3.c包含file2.c和file3.c。
• 这样需要file2.c时只链接tu_file2_3.o，需要file1.c时只链接tu_file1.o，从根源上避免引入不必要的依赖或符号冲突。

二、处理符号冲突场景的额外技巧 #

当程序自身编译了同文件名的代码（比如自己编译了file1.c，又想用库中file2.c），除了上面的分组方案，还可以：

• 给库中符号加前缀：比如把库中file1.c的函数命名为lib_file1_a，从根本上避免符号重名；
• 利用链接器符号优先级：比如Visual Studio的/FORCE:MULTIPLE允许重复符号，链接器会选择第一个遇到的符号；GCC的-Wl,--allow-multiple-definition也有类似效果，但这种方式风险高，容易埋下难以排查的bug，建议谨慎使用。

总结下来，优先级最高的方案是：先尝试启用函数级链接优化（如果工具链支持），不行就调整Unity Build的分组策略，老工具链优先选分组方案。

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