在银河麒麟系统上安装Rust开发环境需先确认底层发行版(Ubuntu/Debian或Anolis/CentOS),再安装C构建工具、通过rustup配置清华镜像源安装工具链、加载环境变量、配置crates.io镜像并添加rust-src组件。

在银河麒麟系统上安装和配置Rust开发环境,需先确认底层发行版类型(Ubuntu/Debian 或 Anolis/CentOS),再选择对应安装路径;若跳过镜像源配置,rustup 下载 rustc 组件大概率卡死超时,无法完成安装。
确认系统底层发行版
打开终端(Ctrl+Alt+T),执行以下命令:
cat /etc/os-release | grep -E "(ID|VERSION_ID)"
观察输出:若 【ID=ubuntu 或 ID=kylin 且 VERSION_ID 含 20.04/22.04】,则为 Debian/Ubuntu 基;若 【ID=anolis 或 ID=centos】,则为 Anolis/CentOS 基。这一步不可跳过,后续所有命令都依赖此判断。
安装基础构建工具
rustc 编译器本身不带链接器,缺失 build-essential 或 Development Tools 会导致 cargo build 直接报错 linker `cc` not found。
Ubuntu/Debian 基:sudo apt update && sudo apt install -y build-essential curl git
Anolis/CentOS 基:sudo dnf groupinstall -y "Development Tools" && sudo dnf install -y curl git
验证:cc --version 和 git --version 都应正常输出版本信息。
通过 rustup 安装 Rust 工具链(推荐)
这是最通用、最可控的方式,支持 nightly/stable 切换与 rust-src 组件安装,适合底层开发。
第一步:设置清华镜像源,避免下载卡死
export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
第二步:执行安装脚本
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
第三步:安装过程中按回车选择默认选项(即输入 1 → Proceed with installation)
第四步:关闭当前终端,重新打开一个新终端窗口——【这一步不可省略,否则 $HOME/.cargo/env 不会自动加载】
第五步:验证安装结果
rustc --version && cargo --version
使用系统包管理器安装(备用方案)
适用于网络受限、仅需快速验证编译能力的场景,但版本较旧且默认不含 rust-src。
方法一(Ubuntu/Debian 基):sudo apt install -y rustc cargo
方法二(Anolis/CentOS 基):sudo dnf install -y rust cargo
注意:若执行 cargo --version 提示 command not found,说明 ~/.cargo/bin 未加入 PATH。此时需编辑 ~/.bashrc,追加 export PATH="$HOME/.cargo/bin:$PATH",然后运行 source ~/.bashrc。
配置 crates.io 国内镜像(必做)
否则新建项目后执行 cargo build 或 cargo run 会因索引拉取缓慢而超时失败。
创建配置文件目录:mkdir -p $HOME/.cargo
写入镜像配置:
echo '[registry]\nindex = "https://rsproxy.cn"' > $HOME/.cargo/config.toml
这一步完成后,cargo 就能从 rsproxy.cn 加速下载 crate 包了。
安装 rust-src 组件(底层开发必需)
没有它,rust-analyzer 无法跳转标准库源码,IDE 支持残缺,RustFS 等信创项目编译也会失败。
执行:rustup component add rust-src
验证:rustup show — 输出中应包含 rust-src (installed)。

















