Rust语言入门全攻略：从选型到首个可发布CLI工具

2.1.2 macOS安装

1. 打开终端（Terminal）。
2. 输入以下命令以下载并执行rustup安装脚本：

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

3. 按照提示选择默认选项（通常是按数字键1确认）。

验证安装结果：

rustc --version
cargo --version

2.1.3 Linux安装（以Ubuntu/Debian为例）

1. 更新系统软件源并安装必要依赖：

   sudo apt update
   sudo apt install -y build-essential curl git
   

2. 下载并执行rustup安装脚本：

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

3. 按照提示选择默认选项（通常是按数字键1确认）。

验证安装状态：

rustc --version
cargo --version

2.2 配置国内镜像源——加速依赖下载

由于网络限制，直接访问crates.io可能较慢甚至失败。建议配置国内镜像源以加快依赖获取速度。

1. 创建或编辑.cargo/config.toml文件（Windows路径为C:\Users\你的用户名\.cargo\config.toml）。
2. 添加以下内容并保存：

   [source.crates-io]
   replace-with = 'ustc'
   
   [source.ustc]
   registry = "git://mirrors.ustc.edu.cn/crates.io-index"
   # 若git协议访问受限，可改用HTTPS协议
   # registry = "https://mirrors.ustc.edu.cn/crates.io-index"
   

2.3 配置开发工具

推荐使用VS Code作为Rust开发IDE，因其提供了优秀的Rust插件支持。

2.3.1 安装VS Code

前往VS Code官网下载对应系统的安装包并完成安装。

2.3.2 安装Rust相关插件

打开VS Code，点击左侧'Extensions'图标，搜索并安装下列插件：

1. Rust Analyzer：提供代码补全、语法高亮、跳转定义等功能。
2. CodeLLDB：用于调试Rust程序。
3. Cargo：集成Cargo命令行工具。
4. Even Better TOML：美化和格式化Cargo.toml等TOML文件。

三、第一个Rust项目：从Hello, World!到可发布的CLI工具

3.1 使用Cargo创建标准项目

在终端中执行以下命令创建新项目：

cargo new hello_rust_cli
cd hello_rust_cli

3.2 项目目录结构解析

生成的项目结构如下所示：

hello_rust_cli/
├── Cargo.lock       # 锁定依赖版本（自动生成，请勿手动修改）
├── Cargo.toml       # 包含项目元数据和依赖信息
└── src/
    └── main.rs      # 主程序入口文件

3.2.1 Cargo.toml内容解析

[package]
name = "hello_rust_cli"     # 项目名称（应符合小写字母+下划线命名规范）
version = "0.1.0"           # 版本号（遵循语义化版本规则 MAJOR.MINOR.PATCH）
edition = "2021"            # 使用的Rust Edition版本

[dependencies]               # 项目所依赖的外部库列表

3.2.2 src/main.rs内容解析

// src/main.rs - Hello, Rust!的标准写法
fn main() {
    println!("Hello, Rust World!");
}

• fn main() 是程序入口函数，Rust会自动调用该函数。
• println!() 是一个宏而非普通函数，用于打印文本到控制台。

3.3 编译、运行、测试项目

3.3.1 编译项目

cargo build                  # 构建debug版本（默认用于开发调试）
cargo build --release        # 构建release版本（优化后的生产环境版本）

构建成功后，将在target/debug/或target/release/目录下生成可执行文件。

3.3.2 运行项目

cargo run                    # 同时编译并运行debug版本
cargo run --release          # 同时编译并运行release版本

预期输出：Hello, Rust World!

3.3.3 测试项目

Rust内置了强大的单元测试能力。我们可以在src/main.rs中添加测试代码，也可单独创建测试文件。

示例测试代码：

#[cfg(test)]
mod tests {
    #[test]
    fn test_hello_world() {
        assert_eq!(1 + 1, 2);
    }
}

运行测试命令：

cargo test

预期输出：test tests::test_hello_world ... ok

3.4 扩展项目：添加命令行参数支持

目标：使程序接受命令行参数，例如：

cargo run -- --name "张三"

期望输出：Hello, 张三!

修改src/main.rs

首先引入clap库来处理命令行参数：

cargo add clap --features derive

然后替换原始内容为：

use clap::Parser;

/// 一个简单的Hello, Rust! CLI工具
#[derive(Parser, Debug)]
#[command(author, version, about, long_about = None)]
struct Args {
    /// 你的名字
    #[arg(short, long)]
    name: String,
}

fn main() {
    let args = Args::parse();
    println!("Hello, {}!", args.name);
}

再次运行扩展后的程序：

cargo run -- --name "张三"

预期输出：Hello, 张三!

3.5 调试项目

利用VS Code的CodeLLDB插件可以方便地调试Rust程序。

操作步骤：

1. 在VS Code中打开项目。
2. 在src/main.rs的println!()行左侧设置断点。
3. 点击左侧'Run and Debug'图标。
4. 选择'LLDB: Launch'创建launch.json配置文件。
5. 点击'Start Debugging'按钮开始调试。

示例launch.json配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "(lldb) Launch",
      "type": "lldb",
      "request": "launch",
      "program": "${workspaceFolder}/target/debug/hello_rust_cli",
      "args": ["--name", "张三"],
      "cwd": "${workspaceFolder}",
      "preLaunchTask": "cargo build"
    }
  ]
}

3.6 发布项目

你可以将项目发布到crates.io供他人使用。

⚠️ 注意：发布前需要先在crates.io注册账户并获取API密钥。

准备工作

1. 注册并登录crates.io账号。
2. 获取API密钥并在本地终端中配置：

   cargo login
   

   粘贴你的API密钥继续。

创建README.md

# hello_rust_cli

一个简单的Hello, Rust! CLI工具。

## 安装

```bash
cargo install hello_rust_cli

使用

hello_rust_cli --name "张三"

输出：Hello, 张三!

许可证

MIT

#### 修改Cargo.toml

补充必要的元数据信息：
```toml
[package]
name = "hello_rust_cli"
version = "0.1.0"
edition = "2021"
authors = ["你的名字 <你的邮箱>"]
description = "一个简单的Hello, Rust! CLI工具"
repository = "https://github.com/你的用户名/hello_rust_cli"
readme = "README.md"
license = "MIT"

[dependencies]
clap = { version = "4.5.4", features = ["derive"] }

发布项目

最后一步，执行发布命令：

cargo publish

预期输出：Published hello_rust_cli v0.1.0

四、Rust新手常见陷阱与避坑指南

4.1 混淆变量的可变性与不可变性

⚠️ 陷阱：Rust中变量默认是不可变的，尝试修改会导致编译错误。

❌ 错误示例：

fn main() {
    let x = 5;
    x = 6; // 编译错误：x is declared as immutable
}

✅ 解决办法：显式声明为可变变量：

fn main() {
    let mut x = 5;
    x = 6;
    println!("x = {}", x); // 输出x = 6
}

4.2 忘记处理Result类型

⚠️ 陷阱：很多函数返回Result类型，未妥善处理将导致编译失败。

❌ 错误示例：

use std::fs::File;

fn main() {
    let file = File::open("test.txt"); // 返回Result<File, io::Error>
}

✅ 解决办法：有多种处理方式：

使用?运算符：

use std::fs::File;
use std::io;

fn read_file() -> io::Result<()> {
    let _file = File::open("test.txt")?;
    Ok(())
}

fn main() {
    if let Err(e) = read_file() {
        println!("文件操作失败：{}", e);
    }
}

使用if let表达式：

use std::fs::File;

fn main() {
    if let Ok(f) = File::open("test.txt") {
        println!("文件打开成功");
    } else {
        println!("文件打开失败");
    }
}

使用match表达式：

use std::fs::File;
use std::io::ErrorKind;

fn main() {
    let file = File::open("test.txt");
    match file {
        Ok(f) => println!("文件打开成功"),
        Err(e) => match e.kind() {
            ErrorKind::NotFound => println!("文件不存在"),
            _ => println!("文件打开失败：{}", e),
        },
    }
}

4.3 混淆引用与所有权

⚠️ 陷阱：Rust的所有权机制确保内存安全，但容易引发误解。

❌ 错误示例：

fn main() {
    let s = String::from("hello");
    takes_ownership(s); // s的所有权转移到takes_ownership函数
    println!("{}", s); // 编译错误：s已经没有所有权了
}

fn takes_ownership(s: String) {
    println!("{}", s);
}

✅ 解决办法：使用引用传递所有权：

fn main() {
    let s = String::from("hello");
    borrows_ownership(&s); // 传递s的引用
    println!("{}", s); // 编译成功：s的所有权还在
}

fn borrows_ownership(s: &String) {
    println!("{}", s);
}

4.4 忘记处理生命周期

⚠️ 陷阱：Rust的生命周期系统防止悬垂引用，忽略可能导致编译错误。

❌ 错误示例：

fn main() {
    let r;
    {
        let x = 5;
        r = &x; // 编译错误：x的生命周期比r短
    }
    println!("{}", r);
}

✅ 解决办法：确保引用生命周期不超过所有者：

fn main() {
    let x = 5;
    let r = &x;
    println!("{}", r);
}

五、总结与展望

5.1 总结

✅ 已完成Rust开发环境的完整搭建（涵盖Windows/macOS/Linux），并配置了国内镜像源以加速依赖下载。 ✅ 理解了Cargo作为Rust标准构建系统和包管理器的核心功能。 ✅ 成功创建了第一个Rust项目Hello, Rust!，并将其扩展为支持命令行参数的CLI工具。 ✅ 掌握了Rust程序的编译、运行、测试、调试、发布流程。 ✅ 学习了Rust新手常见的陷阱及其应对策略。

5.2 展望

后续文章将进一步探讨Rust的基本数据类型和变量系统，包括但不限于：

• 标量类型（整数、浮点数、布尔值、字符）
• 复合类型（元组、数组、切片）
• 字符串类型（String和&str）
• 变量的作用域和shadowing（变量隐藏）
• 类型转换

通过深入学习这些基础知识，你将能够编写更加复杂和高效的Rust应用程序。