strip 符号剥离 ​

核心概念 ​

符号剥离(strip)是从编译好的二进制文件中移除调试符号和其他元数据的过程。这些符号信息在开发和调试时很有用(提供函数名、行号等),但在生产部署时通常不需要,移除后可以显著减小二进制文件的体积。

Cargo 从 Rust 1.59 开始支持在 profile 中配置 strip 选项。剥离符号后,panic 的 backtrace 中将只显示地址而没有函数名,调试器也无法正常工作。

toml
[profile.release]
strip = "symbols"     # 剥离所有符号(推荐生产使用)
# strip = "debuginfo" # 只剥离调试信息,保留符号表
# strip = "none"      # 不剥离(默认)
# strip = true        # 等同于 "symbols"
# strip = false       # 等同于 "none"

strip 选项对比 ​

选项保留内容体积影响backtrace
"none" / false全部符号 + 调试信息最大完整函数名和行号
"debuginfo"符号表中等减小有函数名,无行号
"symbols" / true无最小只有地址
rust
fn main() {
    // strip 影响 panic backtrace 的可读性

    // strip = "none" 时的 backtrace:
    // thread 'main' panicked at 'error', src/main.rs:5:5
    //   0: my_app::inner_function
    //   1: my_app::main

    // strip = "symbols" 时的 backtrace:
    // thread 'main' panicked at 'error', src/main.rs:5:5
    //   0: 0x5555555a1234
    //   1: 0x5555555a5678

    println!("strip 减小体积但降低 backtrace 可读性");
}

实际体积对比 ​

toml
# 一个典型 Web 项目(使用 axum + tokio + serde)

# 无优化
# [profile.release]
# strip = "none"
# → 约 15 MB

# 只剥离调试信息
# [profile.release]
# strip = "debuginfo"
# → 约 8 MB

# 剥离所有符号
# [profile.release]
# strip = "symbols"
# → 约 5 MB

# 全面优化
# [profile.release]
# strip = "symbols"
# lto = true
# codegen-units = 1
# panic = "abort"
# opt-level = "s"
# → 约 3 MB

基本示例 ​

toml
# 生产部署的完整配置
[package]
name = "my-server"
version = "0.1.0"
edition = "2024"

[profile.release]
opt-level = 3
lto = "thin"
codegen-units = 1
strip = "symbols"      # 剥离符号减小体积

# 保留调试信息的 profiling 构建
[profile.profiling]
inherits = "release"
strip = "none"         # 保留所有符号(用于性能分析)
debug = true
rust
fn factorial(n: u64) -> u64 {
    // 在 strip = "symbols" 下,如果这个函数 panic,
    // backtrace 中只会显示地址而不是 "factorial" 函数名
    match n {
        0 | 1 => 1,
        _ => n * factorial(n - 1),
    }
}

fn main() {
    for i in 0..10 {
        println!("{}! = {}", i, factorial(i));
    }

    // 查看二进制大小的命令(Windows PowerShell):
    // (Get-Item .\target\release\my-server.exe).Length / 1MB
    println!("使用 strip = symbols 可以大幅减小二进制体积");
}

常见问题 ​

问题一:strip 后还能调试吗?

strip = "symbols" 后调试器(如 gdb、lldb)无法显示函数名和变量。如果需要调试,保持 strip = "none" 或使用单独的 profiling profile。

问题二:strip 和外部 strip 命令有什么区别?

Cargo 的 strip 选项在链接时执行,等同于在构建后运行系统的 strip 命令。效果相同,但 Cargo 内置的方式更方便。

问题三:strip 对性能有影响吗?

没有。strip 只移除元数据,不改变可执行代码。运行性能完全不受影响。唯一的影响是 panic 时的 backtrace 可读性降低。

问题四:Docker 部署应该使用哪个 strip 级别?

推荐 strip = "symbols"。Docker 镜像中通常不需要调试,体积越小越好。如果需要调试生产问题,可以构建一个带符号的版本单独保存。

适用场景 ​

  • 生产部署:减小部署包体积
  • Docker 容器:最小化镜像大小
  • 嵌入式系统:存储空间有限
  • 发布分发:给用户的二进制文件不需要调试符号

注意事项 ​

  • strip 后 backtrace 中无函数名
  • 不影响运行性能,只影响调试能力
  • 建议保存一份未 strip 的构建用于调试
  • strip = "debuginfo" 是折中选择(保留函数名)
  • 配合 lto 和 panic = "abort" 效果更好
  • 开发和测试构建不要 strip

总结 ​

strip 选项从二进制文件中移除调试符号和元数据以减小体积。三个级别:"none"(保留全部)、"debuginfo"(移除调试信息,保留符号表)、"symbols"(移除全部符号,体积最小)。strip 不影响运行性能,但会降低 panic backtrace 的可读性。生产部署推荐 strip = "symbols",配合 lto、codegen-units = 1、panic = "abort" 可以最大程度减小二进制体积。建议保留一份未 strip 的构建用于问题排查。