初始化 Rust 开发环境

这份指南将帮助你快速搭建一个完整的 Rust 开发环境,包括安装必要的工具和配置镜像源以加速下载。

1. 安装 Rustup

Rustup 是官方的 Rust 安装程序和版本管理工具。

安装步骤

  1. 访问 Rust 官方网站的入门页面:https://www.rust-lang.org/zh-CN/learn/get-started
  2. 网站会根据你的操作系统提供具体的安装命令。对于大多数系统,你可以在终端中运行:
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
    
    在安装过程中,选择默认安装即可。

2. 配置 Rustup 环境变量(可选)

为了加快安装和更新速度,你可以配置环境变量来使用国内的镜像源。

配置方法

  • Windows 系统:在系统环境变量中,新建并添加以下两个变量。

    • 变量名: RUSTUP_DIST_SERVER
    • 变量值: https://mirrors.ustc.edu.cn/rust-static
    • 变量名: RUSTUP_UPDATE_ROOT
    • 变量值: https://mirrors.ustc.edu.cn/rust-static/rustup
  • macOS / Linux 系统:编辑你的 shell 配置文件(例如 ~/.bashrc~/.zshrc),并添加以下内容。

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

    保存并运行 source <你的配置文件> 使更改生效。

3. 安装工具链

如果你需要安装特定的工具链(例如用于交叉编译),可以使用 rustup toolchain install 命令。

示例

安装一个用于 Windows GNU 编译的稳定版工具链:

rustup toolchain install stable-x86_64-pc-windows-gnu

4. 配置 Cargo 镜像

Cargo 是 Rust 的包管理器。配置镜像源可以大幅提升下载依赖包(crates)的速度。

配置步骤

  1. 找到 Cargo 的配置文件:$CARGO_HOME/config.toml
    • Linux/macOS: ~/.cargo/
    • Windows: %USERPROFILE%/.cargo/
  2. 如果该文件不存在,请手动创建它。
  3. 编辑文件,添加以下内容,选择你喜欢的镜像源:
    [source.crates-io]
    # 使用阿里云镜像源来替换官方源。
    # 你可以根据需要更改为 'ustc'、'sjtu' 或 'tuna'。
    replace-with = 'aliyun' 
    
    # 阿里云
    [source.aliyun]
    registry = "sparse+https://mirrors.aliyun.com/crates.io-index/"
    
    # 中国科学技术大学
    [source.ustc]
    registry = "https://mirrors.ustc.edu.cn/crates.io-index"
    
    # 上海交通大学
    [source.sjtu]
    registry = "https://mirrors.sjtug.sjtu.edu.cn/git/crates.io-index/"
    
    # 清华大学
    [source.tuna]
    registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"
    
    # rustcc 社区
    [source.rustcc]
    registry = "https://code.aliyun.com/rustcc/crates.io-index.git"
    

完成以上步骤后,你的 Rust 开发环境就准备好了。

posted on 2025-09-18 19:29  快来吃辣条  阅读(84)  评论(0)    收藏  举报