cargo-run (1) - Linux Manuals

cargo-run: Run the current project


cargo-run - Run the current project


cargo run [OPTIONS] [--] [<ARGS>...]


Run the main binary of the local package (src/

If neither --bin nor --example are given, then if the project only has one bin target it will be run. Otherwise --bin specifies the bin target to run, and --example specifies the example target to run. At most one of --bin or --example can be provided.

All of the trailing arguments are passed to the binary to run. If you're passing arguments to both Cargo and the binary, the ones after -- go to the binary, the ones before go to Cargo.


-h, --help
Print this message.
--bin NAME
Name of the bin target to run.
--example NAME
Name of the example target to run.
-j IN, --jobs IN
Number of parallel jobs, defaults to # of CPUs.
Build artifacts in release mode, with optimizations.
--features FEATURES
Space-separated list of features to also build.
Build all available features.
Do not build the default feature.
--target TRIPLE
Build for the target triple.
--manifest-path PATH
Path to the manifest to compile.
-v, --verbose
Use verbose output.
-q, --quiet
No output printed to stdout.
--color WHEN
Coloring: auto, always, never.


Run the main binary of the current package

cargo run


This work is dual-licensed under Apache 2.0 and MIT terms. See COPYRIGHT file in the cargo source distribution.


cargo(1), cargo-new(1), cargo-init(1), cargo-build(1)