打印一个hello world

创建一个rust项目，mkdir my_project && cd my_project

编写main.rs文件，touch main.rs

在rust中，打印一个hello world非常简单，只需要在main.rs文件中添加以下代码即可：

1
2
3
fn main() {
    println!("hello world");
}

我们需要对main.rs文件进行 编译，执行以下命令：

1
rustc main.rs

这将编译项目并生成可执行文件。

执行以下命令 运行 项目：

1
./main

这将输出hello world。

编译和运行是彼此独立的步骤。

使用cargo包管理器

虽然我们可以使用rustc来编译项目，但是使用cargo包管理器可以更方便地管理项目依赖和构建过程。

Cargo 是 Rust 的构建系统和包管理器。大多数 Rustacean 们使用 Cargo 来管理他们的 Rust 项目，因为它可以为你处理很多任务，比如构建代码、下载依赖库并编译这些库。（我们把代码所需要的库叫做 依赖（dependencies））。

安装了Rust后，Cargo 也会被安装。你可以通过在终端中运行 cargo --version 来检查是否安装了 Cargo。

初始化一个cargo项目

执行以下命令初始化一个cargo项目：

1
cargo new hello_cargo

这将在当前目录创建一个新的cargo项目，包含一个Cargo.toml文件和一个src/main.rs文件。

Cargo.toml文件是cargo项目的配置文件，它包含了项目的元数据和依赖信息。

以下是一个简单的Cargo.toml文件示例：

1
2
3
4
5
6
[package]
name = "hello_cargo"
version = "0.1.0"
edition = "2024"

[dependencies]

这个文件使用 TOML (Tom’s Obvious, Minimal Language) 格式，这是 Cargo 配置文件的格式。

第一行，[package]，是一个片段 section 标题，表明下面的语句用来配置一个包。随着我们在这个文件增加更多的信息，还将增加其他 section。

接下来的三行设置了 Cargo 编译程序所需的配置：项目的名称、项目的版本以及要使用的 Rust 版本。附录 E 会介绍 edition 的值。

最后一行，[dependencies]，是罗列项目依赖的 section 的开始。在 Rust 中，代码包被称为 crates。这个项目并不需要其他的 crate，不过在第二章的第一个项目会用到依赖，那时会用得上这个 section。

cargo build

执行以下命令编译项目：

1
cargo build

这个命令会创建一个可执行文件 target/debug/hello_cargo （在 Windows 上是 target\debug\hello_cargo.exe），而不是放在目前目录下。由于默认的构建方法是调试构建（debug build），Cargo 会将可执行文件放在名为 debug 的目录中。可以通过这个命令运行可执行文件：

1
2
$ ./target/debug/hello_cargo # 或者在 Windows 下为 .\target\debug\hello_cargo.exe
Hello, world!

如果一切顺利，终端上应该会打印出 Hello, world!。

cargo run

cargo build 需要进入到项目目录下执行。这样操作起来还是比较麻烦的。

cargo run 命令会自动编译项目并运行可执行文件。

1
cargo run

这将编译项目并运行可执行文件。

总结

本文介绍了如何使用Rust编写第一个Hello World程序，以及Cargo包管理器的基本使用方法，包括项目创建、编译和运行。

更详细的解释可以参考Rust官方文档 hello world

非官方中文文档: Rust中文文档 hello cargo