lto 链接优化 ​

核心概念 ​

LTO(Link-Time Optimization,链接时优化)是一种在链接阶段进行跨 crate 优化的技术。通常编译器只能在单个编译单元(codegen unit)内进行优化,LTO 允许编译器在链接时看到所有代码,从而执行跨模块的内联、死代码消除、常量传播等优化。LTO 可以显著提升运行速度并减小二进制体积,但会增加编译时间和内存消耗。

Cargo 支持三种 LTO 模式:false(禁用,默认)、"thin"(轻量 LTO,平衡速度和编译时间)、true/"fat"(完整 LTO,最好的优化效果但编译最慢)。

toml
[profile.release]
lto = false      # 禁用 LTO(默认)
# lto = "thin"   # Thin LTO(推荐)
# lto = true     # Fat LTO(等同于 "fat")
# lto = "fat"    # 完整 LTO

LTO 模式对比 ​

模式编译速度优化效果内存消耗适用场景
false最快基本低开发、CI
"thin"中等好中等生产部署(推荐)
true/"fat"最慢最好高最终发布、对性能极致要求
toml
# Thin LTO:推荐的生产配置
# 在优化效果和编译时间之间取得好的平衡
[profile.release]
lto = "thin"
codegen-units = 1

# Fat LTO:最终发布版本
# 编译时间较长但优化最好
[profile.release]
lto = true
codegen-units = 1

LTO 的优化内容 ​

rust
// LTO 允许跨 crate 边界进行以下优化:

// === 1. 跨 crate 内联 ===
// 没有 LTO 时,调用其他 crate 的函数通常不会被内联
// 有 LTO 时,编译器可以将热点函数跨 crate 内联

// === 2. 跨 crate 死代码消除 ===
// 没有 LTO 时,每个 crate 保留所有公共函数
// 有 LTO 时,未使用的函数可以被移除

// === 3. 跨 crate 常量传播 ===
// 编译器可以跨 crate 边界传播常量值

// === 4. 跨 crate 去虚拟化 ===
// 动态分发(trait object)在某些情况下可以被优化为静态分发

fn main() {
    // 实际效果示例:
    // 没有 LTO 时,serde 的序列化函数可能不会被内联
    // 有 LTO 时,编译器可以将序列化路径完全内联展开
    
    let data = vec![1, 2, 3, 4, 5];
    let sum: i32 = data.iter().sum();
    println!("sum = {}", sum);
    
    println!("LTO 让跨 crate 调用也能被深度优化");
}

配合 codegen-units 使用 ​

toml
# codegen-units 控制每个 crate 被分成多少个编译单元
# 与 LTO 配合可以获得最好的优化效果

[profile.release]
lto = "thin"
codegen-units = 1      # 单个编译单元 = 最好的优化机会
                        # 但编译最慢(不能并行编译单个 crate)

# codegen-units = 16   # 默认值,16 个编译单元
                        # 可以并行编译,编译较快
                        # 但优化机会减少

# 推荐组合:
# 开发:lto = false, codegen-units = 256(默认)
# 发布:lto = "thin", codegen-units = 1

基本示例 ​

toml
# 一个实际项目的 LTO 配置

[package]
name = "lto-demo"
version = "0.1.0"
edition = "2024"

# 开发配置:快速编译
[profile.dev]
lto = false
codegen-units = 256

# 发布配置:平衡优化和编译时间
[profile.release]
lto = "thin"
codegen-units = 1
strip = "symbols"

# 最终发布:最大优化
[profile.dist]
inherits = "release"
lto = "fat"
codegen-units = 1
strip = "symbols"
panic = "abort"
rust
use std::time::Instant;

fn compute_heavy(n: u64) -> u64 {
    // 计算密集型操作,LTO 可以优化迭代器链
    (1..=n)
        .filter(|x| x % 2 == 0)
        .map(|x| x * x)
        .sum()
}

fn main() {
    let start = Instant::now();

    let result = compute_heavy(1_000_000);
    
    let elapsed = start.elapsed();
    println!("结果: {}", result);
    println!("耗时: {:?}", elapsed);

    if cfg!(debug_assertions) {
        println!("当前为 debug 构建,性能数据不准确");
        println!("请使用 cargo run --release 测试");
    }
}

常见问题 ​

问题一:Thin LTO 和 Fat LTO 有多大差别?

对大多数项目,Thin LTO 的优化效果已经非常接近 Fat LTO(差距通常在 5% 以内),但编译时间可能只有 Fat LTO 的一半。推荐首选 Thin LTO。

问题二:LTO 会增加多少编译时间?

取决于项目大小。小项目可能增加几秒到几十秒,大型项目(如有大量依赖)可能增加几分钟。Fat LTO 比 Thin LTO 慢得多。

问题三:LTO 对 debug 构建有用吗?

不建议。debug 构建追求编译速度,LTO 会大幅增加编译时间。如果 debug 下性能太慢,可以用 [profile.dev.package."*"] opt-level = 2 替代。

问题四:LTO 和增量编译兼容吗?

Fat LTO 不支持增量编译。Thin LTO 有限度地支持增量编译。如果启用了 LTO 且 incremental = true,实际效果取决于 LTO 模式。

适用场景 ​

  • 生产部署:Thin LTO 提供良好的优化效果
  • 最终发布版本:Fat LTO 提供最佳性能
  • 体积敏感场景:LTO + strip 大幅减小二进制
  • 性能关键应用:数值计算、游戏引擎等

注意事项 ​

  • Thin LTO 是大多数场景的最佳选择
  • Fat LTO 编译时间和内存消耗较大
  • 配合 codegen-units = 1 效果最好
  • LTO 不适合 debug 构建
  • Fat LTO 不支持增量编译
  • 某些 FFI 场景可能与 LTO 不兼容

总结 ​

LTO 在链接阶段进行跨 crate 优化,包括内联、死代码消除、常量传播等。三种模式:false(禁用)、"thin"(推荐,平衡优化和编译时间)、"fat"/true(最佳优化但编译最慢)。Thin LTO 的优化效果接近 Fat LTO 但编译更快。配合 codegen-units = 1 可以获得最好的优化效果。LTO 只适合 release 构建,不建议在 debug 中使用。对大多数生产项目,lto = "thin" + codegen-units = 1 是推荐配置。