rustc

Rust 编译器

补充说明

rustc 是 Rust 的底层编译器，负责把 .rs 文件编译成二进制或库。日常项目通常通过 cargo 调用它，直接使用 rustc 主要用于单文件实验和理解编译选项。

常用示例

rustc main.rs
rustc --edition 2021 main.rs
rustc -O main.rs
rustc --crate-type lib lib.rs
rustc --emit=llvm-ir main.rs
rustc --target x86_64-unknown-linux-gnu main.rs
rustc --print sysroot
rustc --explain E0382
rustc --extern serde=libserde.rlib main.rs

易错点与排错

• 不带 --edition 时可能按旧版语义编译；新代码显式写 --edition 2021 或更高。
• -O 不等于 Cargo 的 release 配置；后者还包含 LTO、调试断言等差异。
• 外部 crate 需要 --extern 和正确的搜索路径；依赖一多就应该用 Cargo。
• 交叉编译需要目标标准库和链接器；只写 --target 通常会失败。
• 错误码可以用 --explain 查详细说明；先看第一个错误，后面的常是连锁反应。
• 直接编译多文件项目不会自动处理模块树之外的依赖；用 mod 声明并保持目录结构。
• 增量编译和缓存由 Cargo 管理更可靠；手写 rustc 命令容易绕过缓存。

相关命令

• cargo — Rust 项目与依赖管理
• rustup — 工具链管理