snippetbashTip

rustc — The Rust compiler. Rust projects usually use `cargo` instead of invoking `rustc` directly. More info

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

thecommandrustrustccliprojectscompiler

Problem

How to use the rustc command: The Rust compiler. Rust projects usually use cargo instead of invoking rustc directly. More information: <https://doc.rust-lang.org/stable/rustc/>.

Solution

rustc — The Rust compiler. Rust projects usually use cargo instead of invoking rustc directly. More information: <https://doc.rust-lang.org/stable/rustc/>.

Compile a binary crate:

rustc {{path/to/main.rs}}

Compile with optimizations (s means optimize for binary size; z is the same with even more optimizations):

rustc {{[-C|--codegen]}} lto {{[-C|--codegen]}} opt-level={{0|1|2|3|s|z}} {{path/to/main.rs}}

Compile with debugging information:

rustc -g {{path/to/main.rs}}

Explain an error message:

rustc --explain {{error_code}}

Compile with architecture-specific optimizations for the current CPU:

rustc {{[-C|--codegen]}} target-cpu={{native}} {{path/to/main.rs}}

Display the target list (Note: You have to add a target using rustup first to be able to compile for it):

rustc --print target-list

Compile for a specific target:

rustc --target {{target_triple}} {{path/to/main.rs}}

Code Snippets

Compile a binary crate

rustc {{path/to/main.rs}}

Compile with optimizations (`s` means optimize for binary size; `z` is the same with even more optimizations)

rustc {{[-C|--codegen]}} lto {{[-C|--codegen]}} opt-level={{0|1|2|3|s|z}} {{path/to/main.rs}}

Compile with debugging information

rustc -g {{path/to/main.rs}}

Explain an error message

rustc --explain {{error_code}}

Compile with architecture-specific optimizations for the current CPU

rustc {{[-C|--codegen]}} target-cpu={{native}} {{path/to/main.rs}}

Context

tldr-pages: common/rustc

Revisions (0)

No revisions yet.