【AI说Rust 03】如何在 macos m1 系统搭建 rust 开发环境

在 macOS M1 上搭建 Rust 开发环境非常直接,主要依赖于官方工具 rustup。下面我为你梳理了一份清晰的步骤指南,包含一些实用技巧。

🔧 安装步骤概览

首先,我们来快速了解核心步骤:

步骤 关键操作/命令 说明
1. 安装命令行工具 xcode-select --install 获取必要的编译器和链接器。
2. 安装 Rust 工具链 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 使用官方脚本安装 rustuprustccargo
3. 配置环境变量 source $HOME/.cargo/env 使命令立即生效;并永久添加到 ~/.zshrc
4. 验证安装 rustc --versioncargo --version 检查版本信息以确认安装成功。
5. 测试项目 cargo new hello_world 然后 cargo run 创建并运行第一个项目,输出 "Hello, world!"。

📥 安装必要的编译依赖

在安装Rust之前,需要确保系统有基本的编译环境。打开终端,执行以下命令来安装Xcode命令行工具:

xcode-select --install

这会提供一个链接器(linker)和一些基础库,许多Rust包在编译时会依赖它们。

⚙️ 安装与配置 Rust

这是最核心的一步。

  1. 安装 Rustup
    在终端中运行官方安装脚本。这将下载并运行 rustup-init 脚本:

    # 1. 设置临时环境变量,使用中国科技大学的镜像源(可选)
    export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
    export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
    
    # 2. 安装 Rustup
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
    

    安装过程中,脚本会提示你进行选择。建议直接按回车键或输入 1 选择默认安装选项,这通常会为你配置好最新的稳定版Rust。

  2. 配置环境变量
    安装完成后,脚本会提示需要重新加载环境变量。你可以通过以下命令立即生效:

    source $HOME/.cargo/env
    

    为了永久生效,建议将下面这行代码添加到你的shell配置文件(例如,如果你使用Zsh,则是 ~/.zshrc)的末尾:

    export PATH="$HOME/.cargo/bin:$PATH"
    

    添加后,执行 source ~/.zshrc 或重新启动终端即可。

🧪 验证安装与创建测试项目

现在,让我们验证一切是否正常工作。

  1. 检查版本
    在终端中运行以下命令,如果它们都能正确显示版本号,则说明安装成功:

    rustc --version
    cargo --version
    
  2. 创建并运行第一个项目
    使用Cargo(Rust的包管理器和构建工具)创建一个新项目是检验环境是否完备的最佳方式:

    cargo new hello_world
    cd hello_world
    cargo run
    

    如果一切顺利,你将在终端中看到 Hello, world! 的输出。

💡 实用技巧与后续步骤

  • 加速下载(可选但推荐):如果你在国内,可能会觉得从官方源下载速度较慢。可以通过设置国内镜像源来大幅提升下载速度。将以下环境变量添加到你的 ~/.zshrc 文件中,然后执行 source ~/.zshrc
    export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
    export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
    
  • 安装Rosetta 2(按需):某些Rust库可能暂时只提供了x86_64架构的预编译组件。为了让M1芯片的Mac能运行这些组件,可以安装Rosetta 2。在终端中执行以下命令即可:
    sudo softwareupdate --install-rosetta
    
    通常Rust工具链会通过Rosetta 2自动处理兼容性问题,你不需要额外干预。
  • 更新与卸载:要更新你的Rust工具链到最新版本,只需运行:
    rustup update
    
    如果需要卸载Rust,可以使用命令:
    rustup self uninstall
    

完成环境搭建后,就可以开始你的Rust学习之旅了!推荐从阅读官方的《Rust程序设计语言》("The Book")开始。希望这份指南对你有帮助!如果你在安装过程中遇到任何具体问题,随时可以再问我。

posted @ 2025-11-06 00:31  #橙续缘  阅读(51)  评论(0)    收藏  举报