Ivan's Blog
Memo

Espressif Rust 安装：RISC-V 与 Xtensa

RustEspressifInstallation

来源（官方文档）：https://docs.espressif.com/projects/rust/book/installation/riscv-and-xtensa.html （访问时间：2025-09-22）

摘要

  • 使用 espup 一站式安装并维护 Espressif 目标所需的工具链（同时覆盖 RISC-V 与 Xtensa）。
  • 基本流程：安装 espup → 运行 espup install →（Unix）按需在 Shell 中加载 $HOME/export-esp.sh 设置环境变量。
  • std 程序还需额外依赖（见文档 “std Development Requirements”）。
  • espup 安装的内容包括：带 Espressif 目标支持的 Rust 分支、支持 RISC-V 的 nightly、带 Xtensa 支持的 LLVM 分支，以及用于最终链接的 GCC 工具链。
  • 官方正推进将相关修改上游化；若遇问题，请参考 Troubleshooting 章节。

安装步骤

  1. 安装 espup
cargo install espup --locked

可选：从 GitHub Releases 下载预编译二进制，或用 cargo-binstall 安装。

  1. 安装所需工具链（覆盖全部受支持的 Espressif 目标）
espup install

提示：若要开发 std 程序，请额外按照文档“std Development Requirements”配置所需软件。

环境变量（Unix）

espup 会在 $HOME/export-esp.sh 中写入构建所需的环境变量，常见用法有三种：

  • 逐次手动加载：
. "$HOME/export-esp.sh"
  • 添加别名，按需加载：
echo "alias get_esprs='. \"$HOME/export-esp.sh\"'" >> ~/.bashrc # 或 .zprofile 等
source ~/.bashrc
  • 直接并入 Shell 配置，自动生效：
cat "$HOME/export-esp.sh" >> ~/.bashrc # 或对应的 shell 配置文件
source ~/.bashrc

Windows 上会生成 %USERPROFILE%\\export-esp.ps1 供参考（无需执行）。

espup 安装了什么

  • 带 Espressif 目标支持的 Rust 分支（与系统上标准 Rust 可共存，通过 rustup 覆盖机制选择）。
  • 支持 RISC-V 目标的 nightly 工具链。
  • 带 Xtensa 支持的 LLVM 分支。
  • 用于最终链接的 GCC 工具链。

其他（Xtensa）安装方式

  • 使用历史 rust-build 安装脚本（已冻结新功能，后续仅在 espup 提供）。
  • 从源码自行编译带 Xtensa 支持的 Rust（计算开销大，仅在确有需要时采用）。

故障排查

如遇错误，请参考文档中的 Troubleshooting 章节。