直接安装rustup即可，它专为简化rust工具链管理而设计；正确命令为curl --proto '=https' --tlsv1.2 -ssf https://sh.rustup.rs | sh，安装后必须执行source "$home/.cargo/env"以配置path，否则rustc/cargo命令不可用。

直接装 rustup 就行，别自己编译或手动改 PATH —— 它就是专为解决这个问题设计的。

rustup 安装命令必须加 --proto '=https' 和 --tlsv1.2

不加这两个参数，在某些企业网络或老旧系统（如 CentOS 7 默认 OpenSSL 版本低）下会报错：curl: (35) error:1407742E:SSL routines:SSL23_GET_SERVER_HELLO:tlsv1 alert protocol version。这不是 Rust 的问题，是 curl 拒绝用不安全的 TLS 版本握手。

• 正确命令只有一行，复制粘贴即可：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
• 如果提示 command not found: curl，先装 curl：sudo apt install curl（Ubuntu/Debian）或 sudo dnf install curl（Fedora/RHEL）
• 脚本运行后按回车选 1) Proceed with installation，别手抖选错成 2) Customize installation —— 新手不需要自定义组件

source $HOME/.cargo/env 不是可选项，是必做动作

装完 rustup 后，rustc 或 cargo 命令仍报 command not found，99% 是因为没执行这步。rustup 把二进制文件放到了 $HOME/.cargo/bin，但这个路径不在默认 PATH 里。

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

• 立即生效：运行 source "$HOME/.cargo/env"（注意引号，防止路径含空格出错）
• 永久生效：把这行加到 ~/.bashrc 或 ~/.zshrc 末尾，再执行 source ~/.bashrc
• 验证是否成功：which cargo 应输出 /home/xxx/.cargo/bin/cargo，不是 /usr/bin/cargo

error: linker `cc` not found 是系统缺 C 工具链，不是 Rust 没装好

运行 cargo build 时出现这个错误，说明 rustc 找不到系统链接器（通常是 gcc 或 clang），和 rustup 本身无关。最小化安装的 Linux（比如云服务器镜像、Docker 基础镜像）默认不带构建工具。

• Ubuntu/Debian：装 build-essential（它包含 gcc、g++、make、libc6-dev 等）：sudo apt install build-essential
• CentOS/RHEL/Fedora：sudo dnf groupinstall "Development Tools"（旧版 yum 用 sudo yum groupinstall "Development Tools"）
• Arch Linux：sudo pacman -S base-devel
• WSL2 用户额外建议装 libssl-dev：sudo apt install libssl-dev，否则像 reqwest 这类 crate 会编译失败
• 验证：cc --version 能输出版本号，且 cargo build 不再报 linker 错误

国内用户卡在 downloading component 'rustc' 怎么办

这不是“网络不通”，而是 rustup 默认从 static.rust-lang.org 下载工具链，该域名在国内常被限速或 DNS 污染。临时换源比折腾代理更稳。

• 安装前就设镜像（关键！）：export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
• 再跑安装命令：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
• 如果已失败，先清理半截安装：rm -rf $HOME/.rustup $HOME/.cargo，再重来
• 别碰 RUSTUP_UPDATE_ROOT —— 它只控制 rustup 自身更新地址，和 rustc 下载无关
• 装完还想加速 crate 下载？改 ~/.cargo/config.toml，配 crates.io 镜像（中科大或腾讯云）

最容易被忽略的是：装完 rustup 后没 source，以及以为装了 gcc 就够了却漏掉 make 或 libc6-dev —— 这些不是 Rust 的问题，但会卡死整个流程。