银河麒麟Rust开发环境安装配置

在银河麒麟系统上搭建Rust开发环境，并不复杂——关键在于掌握几个关键步骤。先确认系统底层发行版，再安装构建工具，然后通过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]' >> $HOME/.cargo/config.toml
echo 'index = "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)，表示安装成功。