CentOS系统Rust环境配置指南

CentOS 系统 Rust 环境配置指南

一 准备与安装

• 更新系统与安装基础编译工具（以 CentOS 7/8 为例）：
  • CentOS 7：sudo yum groupinstall -y “Development Tools” && sudo yum install -y gcc curl
  • CentOS 8：sudo dnf install -y epel-release && sudo dnf update && sudo dnf install -y gcc
• 使用 rustup 安装 Rust 工具链（官方推荐）：
  • curl --proto ‘=https’ --tlsv1.2 -sSf https://sh.rustup.rs | sh
• 使环境变量生效（当前会话）：
  • source “$HOME/.cargo/env”
• 验证安装：
  • rustc --version
  • cargo --version
• 常用后续操作：
  • 更新工具链：rustup update
  • 安装常用组件：rustup component add rustfmt clippy 以上步骤覆盖安装、验证与基础更新，适用于 CentOS 7/8 的常规环境。

二 国内镜像与代理配置

• 提升安装与更新速度（可选，二选一或同时使用）：
  • 设置环境变量（写入 ~/.bashrc 或 /etc/profile 后执行 source）：
    • export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
    • export RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup
  • 或在安装前临时导出上述变量再执行安装脚本。
• 配置 Cargo 包索引镜像（写入文件：$HOME/.cargo/config.toml）：
  • 示例（使用清华源）：
    • [source.crates-io]
      • registry = “https://github.com/rust-lang/crates.io-index”
      • replace-with = ‘tuna’
    • [source.tuna]
      • registry = “https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git”
  • 其他可用镜像：USTC、SJTU、rsproxy 等，按网络情况选择其一即可。
• 企业网络或受限网络可配置 HTTP/HTTPS 代理（写入 $HOME/.cargo/config.toml）：
  • [http]
    • proxy = “http://代理地址:端口”
    • check-revoke = false
    • ssl-version = “tlsv1.2”
  • [https]
    • proxy = “https://代理地址:端口”
    • check-revoke = false
    • ssl-version = “tlsv1.3”
  • [net]
    • git-fetch-with-cli = false 以上镜像与代理配置可显著改善国内下载依赖与工具链更新的速度。

三 快速验证与第一个程序

• 验证工具链：
  • rustc -V && cargo -V
• 使用 rustc 编译运行：
  • echo ‘fn main(){ println!(“Hello, CentOS”); }’ > hello.rs
  • rustc hello.rs && ./hello
• 使用 Cargo 创建与运行项目：
  • cargo new hello_cargo && cd hello_cargo
  • cargo run 以上步骤覆盖从“裸机编译”到“Cargo 工程”的最简路径，便于快速确认环境可用。

四 常见问题与排障

• 命令未找到（command not found: rustc/cargo）：
  • 确认已执行 source “$HOME/.cargo/env”，并检查 ~/.bashrc 或 /etc/profile 是否包含该 source 行；重新登录或重启终端亦可。
• 安装缓慢或失败：
  • 检查网络与 DNS；优先使用国内镜像（RUSTUP_DIST_SERVER / RUSTUP_UPDATE_ROOT 与 Cargo 镜像）；必要时配置代理。
• 构建依赖下载慢或失败：
  • 确认 $HOME/.cargo/config.toml 中已设置 replace-with 为可用镜像；若使用 git:// 协议受限，可切换为 https:// 镜像源。
• 需要自定义安装目录（RUSTUP_HOME / CARGO_HOME）：
  • 在 ~/.bashrc 或相应 profile 中导出变量，例如：
    • export RUSTUP_HOME=“/opt/rust/.rustup”
    • export CARGO_HOME=“/opt/rust/.cargo”
    • source “$CARGO_HOME/env”
  • 注意避免与系统已有 Rust 冲突，并确保目录可写。 以上排障要点覆盖最常见的环境变量、镜像与目录自定义问题。