如何在Rust cdylib中使用.def文件创建转发导出

问题背景 #

尝试通过.def文件为Rust cdylib crate添加转发导出函数时，MSVC链接器抛出error LNK2001: unresolved external symbol ExportName错误。

已尝试的操作 #

• 定义的.def文件：

EXPORTS
   ExportName=ForwardedModule.ExportName

• .cargo\config配置：

[build]
rustflags = [
  "-C", "link-arg=/DEF:C:\\Path\\To\\My\\DefFile\\file.def",
]

• Cargo.toml设置：

crate-type = ["cdylib"]

• 曾在lib.rs中添加以下代码但无效：

extern "C"
{
    #[no_mangle]
    fn ExportName();
}

解决步骤 #

1. 删除lib.rs中的extern "C"块
   这段代码会让Rust编译器认为ExportName是需要外部解析的符号，反而触发链接错误——转发导出不需要在本地声明该函数。

2. 修正.def文件路径格式
   将路径中的反斜杠改为正斜杠，避免Rust处理参数时出现转义问题：

   [build]
   rustflags = [
     "-C", "link-arg=/DEF:C:/Path/To/My/DefFile/file.def",
   ]
   

3. 添加链接器参数允许未解析符号（可选）
   如果仍报错，可添加/FORCE:UNRESOLVED参数，让MSVC链接器接受转发导出的未定义符号：

   [build]
   rustflags = [
     "-C", "link-arg=/DEF:C:/Path/To/My/DefFile/file.def",
     "-C", "link-arg=/FORCE:UNRESOLVED",
   ]
   

原理说明 #

MSVC链接器处理.def文件中的转发导出时，不需要当前库中有对应符号的定义，直接生成指向目标模块的导出转发。但Rust的cdylib默认会强制所有导出符号有本地定义，因此需要通过调整链接参数和移除不必要的本地声明，让链接器正确识别转发规则。

内容的提问来源于stack exchange，提问作者Kurosh D.