当前位置：首页 > news >正文

【Rust编程：从新手到大师】第一个项目Hello，World

news 2025/10/27 8:46:09

本文档以 “输出 Hello,World” 为目标，详细讲解 Rust 项目从创建到运行的完整流程，覆盖环境验证、命令操作、代码编写、程序运行全环节，每个步骤均标注 “操作细节” 和 “注意事项”，确保零基础学生能独立完成。

一、创建项目

步骤 1：选择项目存放目录（推荐桌面）

为方便后续找到项目文件，我们将项目放在 “桌面” 目录下：

操作步骤：

在命令提示符窗口中，输入以下命令（切换到桌面目录）：

cd Desktop

按回车键，若窗口路径变为类似 C:\Users\你的用户名\Desktop>，说明切换成功；

注意事项：
若提示 “系统找不到指定的路径”，先输入 C:（切换到 C 盘，若桌面在 D 盘则输入 D:），再重新执行 cd Desktop；
“你的用户名” 是电脑登录账号名称（如 “Administrator”“ZhangSan”），可通过打开 “此电脑→C 盘→Users” 查看。

步骤 2：用 Cargo 创建 Rust 项目

Rust 官方推荐用 cargo 工具创建项目（自动生成标准目录结构，无需手动新建文件）：

操作步骤：

在命令提示符窗口中，输入以下命令（创建名为 “hello_world” 的项目，项目名必须为英文，不能有空格）：

cargo new hello_world

按回车键，若输出以下内容，说明项目创建成功：

注意事项：

若项目名已存在（如之前创建过同名项目），会提示 “error: destination hello_world already exists”，此时需更换项目名（如 “hello_rust”）；
“binary (application)” 表示创建的是 “可执行程序项目”（区别于 “库项目”），适合我们的 Hello,World 需求。

步骤 3：进入项目目录

创建项目后，需切换到项目文件夹内才能进行后续操作：

操作步骤：

输入以下命令（进入 “hello_world” 项目目录）：

cd hello_world

按回车键，窗口路径会变为 C:\Users\你的用户名\Desktop\hello_world>，说明进入成功；

注意事项：

若输入命令后提示 “系统找不到指定的路径”，检查项目名是否与创建时一致（如是否多写 / 少写字母）。

步骤 4：查看项目结构（理解文件作用）

Cargo 创建的项目有标准结构，需先了解每个文件的作用：

操作步骤：

在桌面找到 “hello_world” 文件夹，双击打开；可看到两个核心内容：

src 文件夹：用于存放 Rust 源代码（所有代码都在这里写）；
Cargo.toml 文件：项目配置文件（记录项目名称、版本、依赖库等信息）；

双击打开 src 文件夹，里面有一个 main.rs 文件 —— 这是 Rust 程序的 “入口文件”，程序运行时会先执行这个文件里的代码；

注意事项：

不要删除或重命名 src 文件夹和 main.rs 文件，否则程序无法正常编译运行；
Cargo.toml 类似项目的 “说明书”，后续添加外部库时需修改此文件。

二、编写 Hello,World 代码（两种方式）

方式 1：直接使用默认代码（推荐零基础）

Cargo 创建项目时，会自动在 main.rs 中生成 Hello,World 默认代码，无需手动编写：

操作步骤：

双击打开 src/main.rs 文件（默认用记事本打开，也可右键选择 “打开方式→记事本”）；
可看到以下默认代码：
```
fn main() {println!("Hello, world!");}
```
直接关闭文件即可（代码已满足需求，无需修改）；

代码解释：
fn main() {}：Rust 程序的 “主函数”，是程序的入口（所有 Rust 程序必须有且只有一个主函数）；
println!("Hello, world!");：打印内容的 “宏”（类似函数），作用是在控制台输出 “Hello, world!”，末尾的 ; 表示语句结束。

方式 2：手动编写代码（加深理解）

若想体验手动编写过程，可按以下步骤操作：

操作步骤：

打开 src/main.rs 文件，删除所有默认内容；
手动输入以下代码（注意符号为英文符号，括号和分号不能少）：

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

按 Ctrl + S 保存文件，关闭即可；

注意事项：

括号必须成对（( 和 )、{ 和 }），若少写一个会导致编译报错；
字符串必须用英文双引号（"），不能用中文引号（“”）；
语句末尾必须加 ;（Rust 语法要求，否则会报错）。

三、运行程序：输出 Hello,World

步骤 1：在命令提示符中执行运行命令

操作步骤：

确保命令提示符窗口的路径是 C:\Users\你的用户名\Desktop\hello_world>（若不是，重新执行 cd Desktop 和 cd hello_world）；
输入以下命令（Cargo 会自动编译并运行程序）：
```
cargo run
```
按回车键，开始执行程序；

步骤 2：查看运行结果

首次运行会经历 “编译” 和 “运行” 两个阶段，最终输出以下内容：

Compiling hello_world v0.1.0 (C:\Users\你的用户名\Desktop\hello_world)
Finished dev [unoptimized + debuginfo] target(s) in 1.5sRunning `target\debug\hello_world.exe`Hello, world!