第一个 Rust 程序 Hello World

《Rust 编程实战》系列第 3 篇

在上一篇文章中，我们完成了 Rust 开发环境的安装，并成功安装了 rustc 和 Cargo。

从这一篇开始，我们正式编写第一个 Rust 程序------经典的 Hello, World!。

虽然这个程序只有一行输出，但它能帮助我们了解 Rust 项目的基本结构、Cargo 的工作方式以及程序是如何编译和运行的。

为什么每门语言都从 Hello World 开始？

几乎所有编程语言的第一课都是输出一句：

text 复制代码

Hello, World!

它的目的不是学习输出，而是验证：

开发环境是否安装成功
编译器是否可以正常工作
IDE 是否配置正确
程序能够成功编译和运行

对于 Rust 来说，Hello World 还能帮助我们认识 Cargo 创建的项目结构。

创建第一个 Rust 项目

打开终端（Windows 可以使用 PowerShell，macOS 和 Linux 使用 Terminal）。

执行：

bash 复制代码

cargo new hello_rust

如果一切正常，会看到类似输出：

text 复制代码

Creating binary (application) `hello_rust` package

这表示 Cargo 已经帮我们创建好了一个完整的 Rust 项目。

进入项目目录：

bash 复制代码

cd hello_rust

查看项目结构

执行：

bash 复制代码

tree

如果没有安装 tree 命令，也可以直接查看目录。

项目结构如下：

text 复制代码

hello_rust/
├── Cargo.toml
└── src
    └── main.rs

这是一个最简单的 Rust 项目。

各个文件的作用如下：

文件	作用
Cargo.toml	项目配置文件
src/main.rs	程序入口
target	编译后的文件（首次编译后生成）

第一次创建时还没有 target 目录。

当执行 cargo build 或 cargo run 后，Cargo 会自动创建。

Cargo.toml 是什么？

打开：

text 复制代码

Cargo.toml

默认内容类似：

toml 复制代码

[package]
name = "hello_rust"
version = "0.1.0"
edition = "2024"

[dependencies]

这里包含了项目的重要信息。

package

描述项目基本信息。

例如：

toml 复制代码

name = "hello_rust"

项目名称。

toml 复制代码

version = "0.1.0"

当前版本。

通常遵循：

text 复制代码

主版本.次版本.修订版本

例如：

text 复制代码

1.0.0

toml 复制代码

edition = "2024"

Rust 使用 Edition（版本规范）来保证新特性与旧项目兼容。

目前常见版本包括：

2018
2021
2024

新项目建议使用最新稳定 Edition。

dependencies

用于管理第三方依赖。

目前为空：

toml 复制代码

[dependencies]

以后学习数据库、Web 开发时，都会在这里添加依赖。

例如：

toml 复制代码

serde = "1.0"
tokio = "1"
axum = "0.8"

Cargo 会自动下载并管理这些库。

main.rs

打开：

text 复制代码

src/main.rs

默认内容如下：

rust 复制代码

fn main() {
    println!("Hello, world!");
}

程序虽然只有两行，却包含了 Rust 最基本的语法。

认识 main 函数

第一行：

rust 复制代码

fn main() {

其中：

rust 复制代码

fn

表示定义函数（Function）。

rust 复制代码

main

表示程序入口。

每个 Rust 可执行程序都有一个：

rust 复制代码

fn main()

程序运行时，会首先执行这里面的代码。

println! 宏

第二行：

rust 复制代码

println!("Hello, world!");

很多初学者会问：

为什么不是：

rust 复制代码

println()

而是：

rust 复制代码

println!()

因为：

println! 不是普通函数。

它是 宏（Macro）。

宏可以在编译期间生成代码，因此比普通函数更加灵活。

以后还会接触：

rust 复制代码

vec!

format!

panic!

assert!

dbg!

它们都是 Rust 提供的常用宏。

修改输出内容

把代码改成：

rust 复制代码

fn main() {
    println!("你好，Rust！");
}

保存后重新运行：

bash 复制代码

cargo run

输出：

text 复制代码

你好，Rust！

说明修改已经生效。

输出多个内容

例如：

rust 复制代码

fn main() {
    println!("欢迎学习 Rust");
    println!("这是第一天");
    println!("Hello Rust");
}

输出：

text 复制代码

欢迎学习 Rust
这是第一天
Hello Rust

Rust 会按照代码顺序依次执行。

使用变量输出

例如：

rust 复制代码

fn main() {
    let name = "Rust";

    println!("Hello {}", name);
}

输出：

text 复制代码

Hello Rust

这里的：

rust 复制代码

{}

表示占位符。

后面的：

rust 复制代码

name

会替换进去。

也可以输出多个变量：

rust 复制代码

fn main() {
    let language = "Rust";
    let year = 2026;

    println!("{} 发布于 {}", language, year);
}

输出：

text 复制代码

Rust 发布于 2026

Cargo run 做了什么？

执行：

bash 复制代码

cargo run

实际上 Cargo 完成了两件事情：

第一步：

编译程序。

相当于：

bash 复制代码

cargo build

第二步：

运行程序。

因此：

bash 复制代码

cargo run

等价于：

bash 复制代码

cargo build

./target/debug/hello_rust

Windows 下：

text 复制代码

target\debug\hello_rust.exe

Cargo build

如果只想编译：

bash 复制代码

cargo build

编译成功后：

项目会新增：

text 复制代码

target/

里面存放所有编译结果。

例如：

text 复制代码

target
└── debug
    └── hello_rust

Release 模式

默认：

bash 复制代码

cargo run

属于 Debug 模式。

如果需要发布正式版本：

执行：

bash 复制代码

cargo build --release

Cargo 会进行更多优化。

生成：

text 复制代码

target/release/

性能会更高。

常见错误

cargo: command not found

说明 Cargo 没有安装成功。

可以检查：

bash 复制代码

cargo --version

如果没有输出版本号，请重新安装 Rust 或检查环境变量。

rustc: command not found

说明编译器没有加入环境变量。

重新打开终端：

或者执行：

bash 复制代码

source ~/.cargo/env

找不到 Cargo.toml

例如：

text 复制代码

could not find Cargo.toml

说明没有进入项目目录。

正确做法：

bash 复制代码

cd hello_rust
cargo run

本章小结

通过本文，我们完成了第一个 Rust 程序的编写，并认识了 Rust 项目的基本结构。

我们学习了：

如何使用 cargo new 创建项目
Cargo.toml 的作用
src/main.rs 是程序入口
fn main() 的意义
println! 宏的使用
cargo run、cargo build 和 cargo build --release 的区别
Rust 项目的编译流程

虽然 Hello World 非常简单，但它已经包含了 Rust 项目的核心组成部分。

在接下来的文章中，我们将进一步学习 Cargo 包管理器，了解它如何管理依赖、构建项目以及帮助我们高效开发 Rust 应用。

下一篇预告

下一篇我们将深入学习 Cargo 包管理器详解，包括：

Cargo 常用命令
添加第三方依赖
编译与运行
Release 与 Debug 的区别
Cargo.lock 和 Cargo.toml 的作用
Rust 项目的最佳实践

掌握 Cargo 后，你将能够更加高效地开发和管理 Rust 项目。