debian配置rust要注意什么

在 Debian 上配置 Rust 环境时，有几个常见坑点和推荐做法，下面按“注意事项 + 建议”来说明。

一、推荐安装方式（非常重要）

✅ 使用官方 rustup（最推荐）

不要直接用 apt 安装 rustc / cargo（除非你只做简单测试）：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

或：

wget https://sh.rustup.rs -O rustup.sh
sh rustup.sh

然后：

source "$HOME/.cargo/env"

✅ 优点：

• 版本最新
• 可多版本切换
• 工具链管理方便

⚠️ apt 中的 Rust 通常版本偏旧，且不易升级。

二、系统依赖（容易忽略）

Rust 编译时需要一些系统库：

sudo apt update
sudo apt install -y \
  build-essential \
  pkg-config \
  libssl-dev \
  curl \
  git

如果是：

• GUI / 图形程序：libx11-dev、libxkbcommon-dev
• 数据库（postgres）：libpq-dev
• 音频/多媒体：对应 -dev 包

三、默认工具链与镜像（国内用户注意）

1️⃣ 设置默认工具链

rustup default stable

2️⃣ 国内加速（非常重要）

cargo 镜像（~/.cargo/config.toml）

[source.crates-io]
replace-with = "rsproxy"

[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"

[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"

或使用清华：

replace-with = "tuna"
[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/crates.io-index.git"

四、Debian 版本相关注意

Debian 稳定版（如 Debian 12）

• glibc 较新，一般没问题
• 但 某些 crate 要求较新 linker / LLVM

如果遇到：

error: linker `cc` not found

✅ 安装：

sudo apt install gcc

五、常见错误与解决

❌ cargo build 很慢

原因：

• 没换源
• 首次编译依赖多

解决：

• 换 cargo 镜像
• 使用 cargo build --release 仅用于最终产物

❌ OpenSSL 相关错误

could not find openssl

解决：

sudo apt install libssl-dev pkg-config

或在 Cargo.toml 使用：

openssl = { version = "0.10", features = ["vendored"] }

六、多版本 & 交叉编译（进阶）

安装 nightly

rustup install nightly
rustup toolchain list

交叉编译（例如 aarch64）

rustup target add aarch64-unknown-linux-gnu
sudo apt install gcc-aarch64-linux-gnu

七、编辑器支持

VS Code

安装：

• Rust Analyzer（官方推荐）
• 不要再用旧版 “Rust” 插件

Vim / Neovim

• rust-analyzer + LSP

八、升级与维护

rustup update
cargo install cargo-update
cargo install-update -a

总结（重点）

✅ 用 rustup
✅ 装 build-essential + libssl-dev
✅ 国内一定换 cargo 源
❌ 别用 apt 的 rust 做开发

如果你告诉我：

• Debian 版本（11 / 12 / 13）
• 是否国内网络
• 做什么项目（Web / 系统 / 嵌入式）

我可以给你一套更精确的配置方案。