cargo-build.md

cargo-build(1)

{{*set actionverb="Build"}} {{*set multitarget=true}}

NAME

cargo-build - Compile the current package

SYNOPSIS

cargo build [options]

DESCRIPTION

Compile local packages and all of their dependencies.

OPTIONS

{{> section-package-selection }}

Target Selection

When no target selection options are given, cargo build will build all binary and library targets of the selected packages. Binaries are skipped if they have required-features that are missing.

{{> options-targets-bin-auto-built }}

{{> options-targets }}

{{> section-features }}

Compilation Options

{{#options}}

{{> options-target-triple }}

{{> options-release }}

{{> options-profile }}

{{> options-ignore-rust-version }}

{{> options-timings }}

{{/options}}

Output Options

{{#options}} {{> options-target-dir }}

{{#option "--out-dir directory" }} Copy final artifacts to this directory.

This option is unstable and available only on the nightly channel and requires the -Z unstable-options flag to enable. See rust-lang#6790 for more information. {{/option}}

{{/options}}

Display Options

{{#options}} {{> options-display }}

{{> options-message-format }}

{{#option "--build-plan" }} Outputs a series of JSON messages to stdout that indicate the commands to run the build.

This option is unstable and available only on the nightly channel and requires the -Z unstable-options flag to enable. See rust-lang#5579 for more information. {{/option}} {{/options}}

Manifest Options

{{#options}} {{> options-manifest-path }}

{{> options-locked }} {{/options}}

{{> section-options-common }}

Miscellaneous Options

{{#options}} {{> options-jobs }} {{> options-keep-going }} {{> options-future-incompat }} {{/options}}

{{> section-environment }}

{{> section-exit-status }}

EXAMPLES

1. Build the local package and all of its dependencies:

   cargo build
   

2. Build with optimizations:

   cargo build --release
   

SEE ALSO

{{man "cargo" 1}}, {{man "cargo-rustc" 1}}