cargo-new

Create new binary project

$ cargo new [project_name]

$ cargo new [project_name] --lib

$ cargo new [project_name] --vcs none

$ cargo new [project_name] --edition [2021]

$ cargo new [path] --name [custom_name]

cargo new [options] path

cargo new creates a new Cargo package in a new directory. It generates a Cargo.toml manifest file, a src/ directory with either a "Hello, World!" binary (`main.rs`) or a library stub (`lib.rs`), and initializes a git repository by default.
The generated Cargo.toml includes the package name, version, and Rust edition. The command respects Cargo configuration for default settings such as author name and email, which are read from git config or environment variables. Custom templates are not supported; use `cargo-generate` for template-based project creation.

--bin

Create binary with src/main.rs (default)

Create library with src/lib.rs

Package name (defaults to directory name)

Rust edition (2015, 2018, 2021, 2024)

Version control system (git, hg, pijul, fossil, none)

Registry for publishing

Verbose output

Suppress output

Use cargo init for existing directories. Default edition is 2024 in recent Rust versions.

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