cargo new 命令参数详解

在 Rust 的 cargo new 命令中，--bin 参数用于指定创建一个 可执行程序（binary） 项目。以下是详细解释和 cargo new 支持的其他常用参数：

--bin 参数的含义

• 作用：创建一个 可执行程序 项目（默认行为）。
• 生成的文件结构：

  tutu/
  ├── Cargo.toml  # 项目配置文件
  └── src/
      └── main.rs # 入口文件（包含 main 函数）
  

• 适用场景：
  • 开发命令行工具、服务器等需要独立运行的程序。
  • 例如：cargo new my_app --bin 会生成一个可执行的 my_app 项目。

cargo new 支持的其他常用参数

1. --lib（创建库项目）

• 作用：创建一个 库（library） 项目。
• 生成的文件结构：

  tutu/
  ├── Cargo.toml
  └── src/
      └── lib.rs  # 库入口文件（无 main 函数）
  

• 适用场景：
  • 开发供其他项目调用的库（crate）。
  • 例如：cargo new my_lib --lib。

2. --name <NAME>（指定项目名称）

• 作用：显式设置项目名称（默认使用目录名）。
• 示例：

  cargo new tutu --bin --name "my_project"
  

  • 项目目录名仍是 tutu，但 Cargo.toml 中的 name = "my_project"。

3. --vcs <VCS>（指定版本控制系统）

• 作用：控制是否初始化 Git 仓库。
• 可选值：
  • git（默认）：初始化 Git 仓库。
  • none：不初始化任何 VCS。
  • hg（Mercurial）、pijul、fossil：其他版本控制系统（较少用）。
• 示例：

  cargo new tutu --bin --vcs none  # 不初始化 Git
  

4. --edition <YEAR>（指定 Rust 版本）

• 作用：设置项目的 Rust 版本（如 2015、2018、2021、2024）。
• 默认值：当前稳定版 Rust 的默认版本（如 2021）。
• 示例：

  cargo new tutu --bin --edition 2021
  

5. --registry <REGISTRY>（指定包注册表）

• 作用：设置依赖包的注册表
• 示例：

  cargo new tutu --bin --registry my-registry
  

完整命令示例

# 创建一个可执行程序，不初始化 Git，指定 Rust 2021 版本
cargo new tutu --bin --vcs none --edition 2021

# 创建一个库项目
cargo new my_lib --lib

总结

通过组合这些参数，可以灵活控制 cargo new 的行为。例如，开发库时用 --lib，开发工具时用 --bin。