如何剥离静态库符号或在链接时仅导入特定符号（macOS环境）

你需要从静态库只保留指定符号、隐藏其余内容，Linux的--exclude-libs=ALL在macOS不可用，下面是适配macOS+Linux的跨平台解决方案，全部支持CMake集成：

一、链接阶段直接控制符号导出（最简单的跨平台方式） #

macOS 端配置 #

macOS的ld链接器支持-exported_symbols_list参数，先创建一个符号清单文件（比如exported_symbols.txt），只写需要保留的符号（C语言符号要加下划线前缀，C++用mangled后的符号）：

_g
_h

在CMake里给目标添加链接选项：

if(APPLE)
    set(EXPORT_SYMBOLS_FILE "${CMAKE_CURRENT_SOURCE_DIR}/exported_symbols.txt")
    target_link_options(你的目标名称 PRIVATE "-Wl,-exported_symbols_list,${EXPORT_SYMBOLS_FILE}")
endif()

Linux 端配置 #

继续用你熟悉的--exclude-libs=ALL，CMake里直接加：

if(UNIX AND NOT APPLE)
    target_link_options(你的目标名称 PRIVATE "-Wl,--exclude-libs=ALL")
    # 要是需要更精准的单符号控制，也可以用--dynamic-list指定符号清单，写法和macOS类似
endif()

跨平台整合版CMake代码 #

把上面的逻辑合并，还能自动生成macOS的符号清单：

# 定义你需要保留的符号
set(NEEDED_SYMBOLS g h)

# Linux：隐藏静态库所有非必要符号
if(UNIX AND NOT APPLE)
    target_link_options(你的目标名称 PRIVATE "-Wl,--exclude-libs=ALL")
endif()

# macOS：自动生成符号清单并指定导出
if(APPLE)
    set(TMP_SYMBOLS_FILE "${CMAKE_CURRENT_BINARY_DIR}/export_symbols.txt")
    file(WRITE ${TMP_SYMBOLS_FILE} "")
    foreach(sym ${NEEDED_SYMBOLS})
        file(APPEND ${TMP_SYMBOLS_FILE} "_${sym}\n")
    endforeach()
    target_link_options(你的目标名称 PRIVATE "-Wl,-exported_symbols_list,${TMP_SYMBOLS_FILE}")
endif()

二、预处理静态库：彻底剔除无用目标文件（更极致的控制） #

要是链接器参数不够用，还可以提前处理静态库，只保留包含目标符号的目标文件，再重新打包：

macOS 预处理脚本（可集成到CMake） #

# 列出静态库内的所有目标文件
ar -t liba.a > obj_list.txt
# 筛选出包含指定符号的目标文件
for obj in $(cat obj_list.txt); do
    nm -arch x86_64 $obj | grep -q "_g" && echo $obj >> keep_objs.txt
done
# 重新打包成过滤后的静态库
ar cr liba_filtered.a $(cat keep_objs.txt)

Linux 预处理脚本 #

# 提取包含目标符号的目标文件
nm liba.a | grep -E "(T|W) g" | awk '{print $3}' > keep_syms.txt
objcopy --only-keep-debug liba.a liba_temp.a
objcopy --redefine-syms=keep_syms.txt liba.a liba_filtered.a

CMake自动化预处理 #

用add_custom_command把预处理步骤整合到构建流程：

# 处理liba.a，生成过滤后的库
add_custom_command(
    OUTPUT liba_filtered.a
    COMMAND bash -c "ar -t liba.a > obj_list.txt && for obj in $(cat obj_list.txt); do nm -arch x86_64 $obj | grep -q '_g' && echo $obj >> keep_objs.txt; done && ar cr liba_filtered.a $(cat keep_objs.txt)"
    DEPENDS liba.a
    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
)

# 处理libb.a，生成过滤后的库
add_custom_command(
    OUTPUT libb_filtered.a
    COMMAND bash -c "ar -t libb.a > obj_list.txt && for obj in $(cat obj_list.txt); do nm -arch x86_64 $obj | grep -q '_h' && echo $obj >> keep_objs.txt; done && ar cr libb_filtered.a $(cat keep_objs.txt)"
    DEPENDS libb.a
    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
)

# 链接过滤后的静态库
target_link_libraries(你的目标名称 PRIVATE liba_filtered.a libb_filtered.a)

注意点 #

• C++符号要注意mangling问题：用nm -C查看demangled后的符号，再找到对应的原始mangled符号写入清单。
• 如果保留的符号依赖未导出的符号（比如g()调用f()），只要链接时能找到f()的实现，程序依然能正常运行，只是f()不会暴露给最终可执行文件。
• macOS下如果是arm64架构，把nm -arch x86_64改成nm -arch arm64即可。

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