在GCC/LLVM链接器中实现MSVC式函数重导出（Unix平台）

核心需求 #

无需编写函数包装器、不依赖上游库头文件，将上游共享库的符号重导出到自己的共享库中，模拟MSVC /export:myfunction=upstreamlib.myfunction 的行为。

Linux 平台方案（GNU ld/lld） #

方法1：单符号重导出（链接器脚本） #

1. 创建链接器脚本 reexport.ld，内容如下：

# 声明要从上游库导入的符号（注意：需使用上游库中的实际符号名，C++函数要写 mangled 名）
EXTERN(upstreamlib_myfunction)
# 将上游符号映射为自己的导出符号
EXPORT(myfunction = upstreamlib_myfunction)

2. 在 Rust 的 Cargo.toml 中配置链接器参数：

[lib]
crate-type = ["cdylib"]

[profile.release]
rustflags = [
    # 强制链接上游库，避免链接器自动丢弃未直接引用的符号
    "-C", "link-arg=-lupstreamlib",
    "-C", "link-arg=--no-as-needed",
    # 指定链接器脚本
    "-C", "link-arg=-T./reexport.ld",
]

方法2：批量重导出所有上游符号 #

如果需要导出上游库的全部符号，可使用动态列表文件替代链接器脚本：

1. 创建 dynamic-list.txt：

{
    global: *;  # 导出所有符号
    local: *;
};

2. 修改 Cargo.toml 的 rustflags：

rustflags = [
    "-C", "link-arg=-lupstreamlib",
    "-C", "link-arg=--no-as-needed",
    "-C", "link-arg=--dynamic-list=./dynamic-list.txt",
]

macOS 平台方案（ld64） #

macOS 的链接器提供了更直接的重导出选项：

方法1：批量重导出整个上游库 #

直接使用 -reexport_library 参数将上游 dylib 的所有符号重导出：

[lib]
crate-type = ["cdylib"]

[profile.release]
rustflags = [
    "-C", "link-arg=-reexport_library",
    "-C", "link-arg=/path/to/libupstreamlib.dylib",
]

方法2：单符号重导出 #

如果只需要导出特定符号，使用 -alias 和 -export_symbol 组合：

rustflags = [
    "-C", "link-arg=-lupstreamlib",
    # 将上游符号映射为自己的符号（注意 macOS 符号默认带下划线前缀）
    "-C", "link-arg=-alias",
    "-C", "link-arg=_upstreamlib_myfunction",
    "-C", "link-arg=_myfunction",
    # 导出该符号
    "-C", "link-arg=-export_symbol",
    "-C", "link-arg=_myfunction",
]

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

• --just-symbols=upstreamlib 仅导入上游库的符号表，但不会链接上游库本身，导致链接器无法将符号关联到你的库。
• EXPORTS { global: *; } 没有明确指定要导出的符号来源，且如果上游库未被强制链接（--no-as-needed），链接器会自动丢弃未被直接引用的符号。

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