Rust 安装与运行指南

🦀 Rust 安装与运行指南

专为Rust小白准备的详细安装和运行教程

📋 目录

环境准备
Rust安装步骤
验证安装
编写第一个程序
编译运行方法
常见问题解决
开发工具推荐
下一步学习

🖥️ 环境准备

支持的操作系统

✅ Windows 10/11
✅ macOS
✅ Linux (Ubuntu, CentOS, etc.)

系统要求

至少 1GB 可用磁盘空间
稳定的网络连接（用于下载）

🚀 Rust安装步骤

Windows用户 (推荐方式)

步骤1：下载安装程序

访问官方网站：https://rustup.rs/
点击下载 rustup-init.exe
运行下载的安装程序

步骤2：执行安装

双击运行 rustup-init.exe
看到命令行界面时，直接按回车使用默认设置
等待下载和安装完成（可能需要几分钟）
看到 "Rust is installed now. Great!" 表示安装成功

步骤3：重启终端

重要：关闭所有终端和命令行窗口
重新打开PowerShell或VS Code

macOS用户

bash 复制代码

# 在终端中运行
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 然后重启终端或运行
source ~/.cargo/env

Linux用户

bash 复制代码

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

# 然后重启终端或运行
source ~/.cargo/env

✅ 验证安装

打开新的终端/PowerShell，运行以下命令验证安装：

bash 复制代码

# 检查Rust编译器版本
rustc --version

# 检查Cargo包管理器版本
cargo --version

# 检查Rustup工具版本
rustup --version

期望输出示例：

复制代码

rustc 1.75.0 (82e1608df 2023-12-21)
cargo 1.75.0 (1d8b05cdd 2023-11-20)
rustup 1.26.0 (5af9b9484 2023-04-05)

📝 编写第一个程序

方法1：单文件程序

创建文件 hello.rs：

rust 复制代码

fn main() {
    println!("Hello, Rust!");
    println!("你好，Rust！");
    
    // 简单的变量使用
    let name = "Rust新手";
    println!("欢迎 {}", name);
    
    // 基本计算
    let x = 10;
    let y = 20;
    println!("{} + {} = {}", x, y, x + y);
}

方法2：Cargo项目（推荐）

bash 复制代码

# 创建新项目
cargo new my_rust_app

# 进入项目目录
cd my_rust_app

# 编辑 src/main.rs 文件

🔧 编译运行方法

单文件编译运行

在PowerShell中（Windows）：

powershell 复制代码

# 分步执行（推荐新手）
rustc hello.rs
./hello.exe

# 一键编译运行（PowerShell语法）
rustc hello.rs; if ($?) { ./hello.exe }

在Git Bash/命令提示符中：

bash 复制代码

# 一键编译运行（Bash语法）
rustc hello.rs && ./hello.exe

Cargo项目运行

bash 复制代码

# 进入项目目录
cd my_rust_app

# 编译并运行（推荐）
cargo run

# 仅编译
cargo build

# 编译优化版本
cargo build --release

# 运行优化版本
./target/release/my_rust_app.exe  # Windows
./target/release/my_rust_app       # Linux/macOS

🔧 常见问题解决

问题1：命令未找到

错误：rustc: command not found 或 cargo: command not found

解决方案：

重启终端/PowerShell
重新运行安装程序
手动添加PATH：~/.cargo/bin (Linux/macOS) 或 %USERPROFILE%\\.cargo\\bin (Windows)

问题2：网络下载慢

解决方案：使用国内镜像

powershell 复制代码

# Windows PowerShell
$env:RUSTUP_DIST_SERVER = "https://mirrors.ustc.edu.cn/rust-static"
$env:RUSTUP_UPDATE_ROOT = "https://mirrors.ustc.edu.cn/rust-static/rustup"

bash 复制代码

# Linux/macOS
export RUSTUP_DIST_SERVER="https://mirrors.ustc.edu.cn/rust-static"
export RUSTUP_UPDATE_ROOT="https://mirrors.ustc.edu.cn/rust-static/rustup"

问题3：编译错误

常见原因：

语法错误
文件路径错误
权限问题

调试方法：

bash 复制代码

# 详细错误信息
rustc hello.rs --verbose

# 检查语法
cargo check  # (在Cargo项目中)

问题4：运行时找不到可执行文件

Windows PowerShell ：使用 ./filename.exe
Linux/macOS ：使用 ./filename

🛠️ 开发工具推荐

VS Code (强烈推荐)

安装扩展：

rust-analyzer - Rust语言支持
CodeLLDB - 调试支持
Better TOML - Cargo.toml文件支持
Error Lens - 行内错误显示

其他编辑器

IntelliJ IDEA + Rust插件
Vim + rust.vim
Sublime Text + Rust Enhanced

终端选择

Windows：PowerShell, Windows Terminal, Git Bash
macOS：Terminal, iTerm2
Linux：各发行版默认终端

📚 下一步学习

学习路径建议

基础语法 (1-2周)
- 变量和数据类型
- 控制流程 (if/else, loop, match)
- 函数和模块
核心概念 (2-3周)
- 所有权系统 (Ownership) ⭐重要
- 借用和引用 (Borrowing)
- 结构体和枚举
错误处理 (1周)
- Result和Option类型
- panic!和错误传播
- 自定义错误类型
实战项目 (按兴趣选择)
- CLI工具开发
- Web开发 (actix-web, axum)
- GUI应用 (egui, tauri)
- 系统编程
- 区块链开发

学习资源

官方资源：

📖 The Rust Book - 官方教程
🧪 Rust by Example - 实例学习
📚 Rust标准库文档

中文资源：

📖 Rust程序设计语言（中文版）
🎓 Rust语言圣经

实践平台：

🏃 Rustlings - 交互式练习
⚡ Exercism Rust Track - 编程练习

🎯 小贴士

编程建议

✅ 从小项目开始，逐步增加复杂度
✅ 多看文档，善用 cargo doc --open
✅ 加入Rust社区，参与讨论
✅ 不要害怕编译错误，Rust编译器很友好

常用命令速查

bash 复制代码

cargo new project_name    # 创建新项目
cargo run                 # 编译并运行
cargo build               # 仅编译
cargo test                # 运行测试
cargo doc --open          # 生成并打开文档
cargo update              # 更新依赖
rustup update             # 更新Rust工具链

🎉 恭喜你开始Rust学习之旅！记住：Rust学习曲线较陡，但一旦掌握将获得强大的编程能力。保持耐心，多动手实践！