多种方式的Rust静态编译

在 Rust 中进行静态编译有多种方式，具体取决于你的目标平台和需求。以下是详细的静态编译方法：

🐧 Linux 平台静态编译

使用 musl 目标（推荐）

# 安装 musl 目标
rustup target add x86_64-unknown-linux-musl

# 静态编译
cargo build --target x86_64-unknown-linux-musl --release

# 或者使用更简单的方式
cargo build --target x86_64-unknown-linux-musl

使用 gnu 目标进行静态链接

# 安装必要的工具链 (Ubuntu/Debian)
sudo apt-get install musl-tools

# 静态编译
RUSTFLAGS="-C target-feature=+crt-static" cargo build --target x86_64-unknown-linux-gnu --release

🪟 Windows 平台静态编译

# 使用 MSVC 工具链（默认）
cargo build --target x86_64-pc-windows-msvc --release

# 或者使用 GNU 工具链
cargo build --target x86_64-pc-windows-gnu --release

🍎 macOS 平台静态编译

# macOS 默认编译已经是大部分静态链接
cargo build --target x86_64-apple-darwin --release

# 或者通用方式
cargo build --release

📦 配置 Cargo.toml 进行静态编译

在 Cargo.toml 中添加配置：

[target.x86_64-unknown-linux-musl]
rustflags = ["-C", "target-feature=+crt-static"]

[target.x86_64-pc-windows-msvc]
rustflags = ["-C", "target-feature=+crt-static"]

🔧 常用静态编译命令

创建完全静态的二进制文件

# Linux musl (完全静态)
cargo build --target x86_64-unknown-linux-musl --release

# 检查二进制文件是否静态链接
file target/x86_64-unknown-linux-musl/release/your_binary
ldd target/x86_64-unknown-linux-musl/release/your_binary

交叉编译示例

# 从 Linux 编译 Windows 静态二进制
rustup target add x86_64-pc-windows-gnu
cargo build --target x86_64-pc-windows-gnu --release

# 从 macOS 编译 Linux 静态二进制
rustup target add x86_64-unknown-linux-musl
cargo build --target x86_64-unknown-linux-musl --release

🛠️ 安装必要的工具链

# 安装常用目标
rustup target add x86_64-unknown-linux-musl
rustup target add x86_64-pc-windows-gnu
rustup target add x86_64-apple-darwin

# 安装交叉编译工具
# Ubuntu/Debian
sudo apt-get install musl-tools musl-dev
# macOS
brew install filosottile/musl-cross/musl-cross

📋 验证静态编译结果

编译后验证二进制文件：

# 检查文件类型
file target/release/your_binary

# 检查动态依赖 (Linux)
ldd target/release/your_binary

# 对于静态编译，ldd 应该显示 "not a dynamic executable"

⚡ 一键静态编译脚本

创建 build-static.sh：

#!/bin/bash
TARGET="x86_64-unknown-linux-musl"
echo "Building static binary for $TARGET"
cargo build --target $TARGET --release
echo "Build complete: target/$TARGET/release/your_binary"

💡 注意事项

1. musl 限制：musl 版本可能缺少某些 glibc 的特性
2. C 依赖：如果有 C 依赖，需要确保它们也静态编译
3. 文件大小：静态二进制文件通常更大
4. 性能：musl 在某些情况下可能性能略低于 glibc

推荐使用 x86_64-unknown-linux-musl 目标来获得真正完全静态的 Linux 二进制文件。