Rust发布版公共函数未出现在符号表的问题排查

核心原因：死代码消除优化 #

Rust编译器在release模式下默认开启严格的死代码消除——哪怕函数是pub修饰的公共函数，只要当前 crate 内部没有任何代码引用它，也没有特殊标记要求保留，编译器就会直接移除它的代码和符号。这是Rust默认的优化逻辑：没被用到的代码就是无用代码，没必要留在编译产物里。

不同编译产物的表现差异 #

• rlib静态库：rlib是Rust专属的静态库格式，主要供其他Rust crate编译时链接。编译器会在最终链接阶段才决定是否保留符号，所以直接查看rlib的符号表看不到未被引用的pub函数是正常的——只有当其他crate实际引用这个函数时，它才会被纳入最终可执行文件。
• dylib动态库：动态库同样会执行死代码消除，因为编译器无法预知外部是否会调用该函数，除非你明确告知它要保留符号。

解决办法 #

要让函数符号出现在编译产物中，可根据需求选择以下方式：

1. 内部引用该函数 #

只要在库内部随便找个地方调用一次这个函数，编译器就会认定它是有用的，不会被消除。比如在lib.rs里加一段无用调用：

pub fn test_function_base001() -> i32 {
    2
}

// 内部占位调用，避免被死代码消除
#[allow(dead_code)]
fn _keep_test_func() {
    let _ = test_function_base001();
}

2. 用#[no_mangle]+pub extern "C"标记 #

如果要让函数能被非Rust代码（比如C）调用，这两个标记可以强制保留原始函数名：

#[no_mangle]
pub extern "C" fn test_function_base001() -> i32 {
    2
}

#[no_mangle]会禁止编译器修改函数名（Rust默认会给符号加前缀和哈希混淆），extern "C"采用C调用约定，这时用readelf就能直接看到原始函数名。

3. 用#[used]属性强制保留 #

如果只是想保留Rust原生符号，不需要兼容C，直接加#[used]属性即可：

#[used]
pub fn test_function_base001() -> i32 {
    2
}

这个属性会告诉编译器：不管有没有被引用，这个函数必须保留。

4. 关闭release模式的死代码消除（不推荐） #

修改Cargo.toml的release配置，全局关闭死代码消除，但会导致编译产物体积增大：

[profile.release]
opt-level = 3
# 关闭死代码消除
dead_code_elimination = false

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