Rust 是一門強調內存安全、高性能和并發(fā)可靠性的系統(tǒng)級編程語言。在 Linux 環(huán)境中學習和使用 Rust 非常合適，因為 Linux 本身擁有完善的編譯工具鏈、包管理器、終端生態(tài)和服務器部署環(huán)境。

本文專注于 Linux 下搭建 Rust 環(huán)境，不展開 Windows 和 macOS。你將完成從系統(tǒng)依賴安裝、rustup 安裝、Cargo 鏡像配置、VS Code 或終端開發(fā)、創(chuàng)建項目、運行測試到常見問題排查的完整流程。

建議使用 rustup 安裝 Rust，而不是直接使用發(fā)行版軟件源里的 rustc。rustup 可以管理 stable、beta、nightly 多套工具鏈，也能安裝 rustfmt、clippy、rust-src 等常用組件。

圖示說明：Linux 搭建 Rust 的核心流程是“準備系統(tǒng)編譯依賴 -> 安裝 rustup -> 配置 Cargo -> 創(chuàng)建項目 -> 編譯運行 -> 配置編輯器與調試工具”。

一、Linux 下 Rust 環(huán)境由哪些部分組成

1.1 核心工具說明

Linux 上的 Rust 開發(fā)環(huán)境通常由下面幾部分組成：

可以簡單理解為：rustup 管工具鏈，rustc 管編譯，cargo 管項目，系統(tǒng)編譯依賴負責鏈接本地庫。

1.2 推薦安裝路線

Linux 下推薦按下面順序搭建：

1. 確認發(fā)行版類型和系統(tǒng)架構。
2. 安裝基礎編譯依賴。
3. 使用官方腳本安裝 rustup。
4. 配置 Cargo 環(huán)境變量。
5. 配置 Cargo sparse 協(xié)議或國內鏡像。
6. 安裝 rustfmt、clippy、rust-src。
7. 創(chuàng)建項目并運行 cargo run。
8. 配置 VS Code、Neovim 或 JetBrains RustRover。
9. 執(zhí)行 cargo fmt、cargo clippy、cargo test 做完整驗證。

二、準備工作：確認系統(tǒng)與架構

2.1 查看 Linux 發(fā)行版

不同 Linux 發(fā)行版安裝系統(tǒng)依賴的命令不同。先查看系統(tǒng)信息：

cat /etc/os-release

常見輸出中會包含 ID 和 VERSION_ID。例如 Ubuntu 可能是：

也可以查看內核版本：

uname -a

2.2 查看 CPU 架構

Rust 支持多種架構。開發(fā)機常見是 x86_64 或 aarch64：

uname -m

架構說明：

如果你只是普通 Linux 電腦或云服務器，大概率是 x86_64。

三、安裝系統(tǒng)編譯依賴

3.1 Ubuntu / Debian

Ubuntu 和 Debian 推薦先安裝下面這些依賴：

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

各依賴作用如下：

3.2 Fedora / RHEL / CentOS Stream

Fedora 可以使用：

sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y curl git pkg-config openssl-devel ca-certificates

如果是 RHEL 或 CentOS Stream，命令也基本類似：

sudo dnf install -y gcc gcc-c++ make curl git pkg-config openssl-devel ca-certificates

3.3 Arch Linux / Manjaro

Arch 系發(fā)行版使用 pacman：

sudo pacman -Syu --needed base-devel curl git pkgconf openssl ca-certificates

base-devel 中包含常用編譯工具，適合 Rust 編譯本地依賴。

3.4 openSUSE

openSUSE 可以使用：

sudo zypper refresh
sudo zypper install -y -t pattern devel_basis
sudo zypper install -y curl git pkg-config libopenssl-devel ca-certificates

如果你使用其他發(fā)行版，核心思路不變：準備 C 編譯器、鏈接器、curl、git、pkg-config 和 OpenSSL 開發(fā)包。

四、使用 rustup 安裝 Rust

4.1 官方安裝命令

Rust 官方推薦通過 rustup 安裝：

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

安裝過程中一般選擇默認選項即可，也就是：

• stable 工具鏈
• 當前系統(tǒng)對應 target
• 默認 profile
• 自動寫入 shell 配置

4.2 讓環(huán)境變量立即生效

安裝完成后，當前終端可能還識別不到 cargo。執(zhí)行：

source "$HOME/.cargo/env"

然后檢查版本：

rustup --version
rustc --version
cargo --version

如果三個命令都能輸出版本號，說明 Rust 核心環(huán)境已經安裝成功。

4.3 檢查 PATH 配置

Rust 默認安裝到用戶目錄：

~/.cargo/bin

可以查看 PATH：

echo "$PATH"

如果沒有 ~/.cargo/bin，可以手動寫入 shell 配置。

Bash 用戶：

echo 'source "$HOME/.cargo/env"' >> ~/.bashrc
source ~/.bashrc

Zsh 用戶：

echo 'source "$HOME/.cargo/env"' >> ~/.zshrc
source ~/.zshrc

Fish 用戶：

fish_add_path $HOME/.cargo/bin

五、配置 Rust stable 工具鏈

5.1 設置默認工具鏈

建議默認使用 stable：

rustup default stable

查看當前 active toolchain：

rustup show

輸出中會看到當前默認工具鏈和安裝目錄。

5.2 更新工具鏈

Rust 會持續(xù)發(fā)布新版本，日?？梢允褂茫?/p>

rustup update

如果只想更新 stable：

rustup update stable

5.3 安裝常用組件

推薦安裝：

rustup component add rustfmt clippy rust-src

組件說明：

六、配置 Cargo 下載源

6.1 使用 sparse 協(xié)議

較新的 Cargo 支持 sparse registry，下載索引更快。創(chuàng)建或編輯：

mkdir -p ~/.cargo
nano ~/.cargo/config.toml

寫入：

[registries.crates-io]
protocol = "sparse"

保存后測試：

cargo search serde

6.2 配置國內鏡像

如果訪問 crates.io 較慢，可以配置鏡像。以 rsproxy 為例：

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

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

[source.rsproxy-sparse]
registry = "sparse+https://rsproxy.cn/index/"

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

[net]
git-fetch-with-cli = true

配置完成后運行：

cargo search tokio

能正常返回搜索結果，說明 Cargo 索引訪問正常。

6.3 代理環(huán)境變量

如果你在公司網絡、校園網或代理環(huán)境中，也可以設置代理：

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

也可以只對 Git 設置代理：

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

取消代理：

git config --global --unset http.proxy
git config --global --unset https.proxy

七、創(chuàng)建第一個 Rust 項目

7.1 使用 cargo new

進入工作目錄后執(zhí)行：

cargo new hello_rust
cd hello_rust

項目結構如下：

hello_rust
├── Cargo.toml
└── src
    └── main.rs

7.2 查看 Cargo.toml

Cargo.toml 是 Rust 項目的配置文件：

[package]
name = "hello_rust"
version = "0.1.0"
edition = "2021"

[dependencies]

字段說明：

• name：項目名稱。
• version：項目版本。
• edition：Rust edition。
• dependencies：第三方依賴。

7.3 編寫 main.rs

打開 src/main.rs：

fn main() {
    println!("Hello, Linux Rust!");
}

運行：

cargo run

看到下面輸出就說明成功：

Hello, Linux Rust!

八、Cargo 常用命令

8.1 構建與運行

Rust 項目日常開發(fā)基本都圍繞 Cargo 展開：

8.2 推薦提交前命令

提交代碼前建議執(zhí)行：

cargo fmt
cargo clippy -- -D warnings
cargo test

這三條命令分別檢查格式、代碼質量和行為正確性。

8.3 release 構建

發(fā)布二進制程序時使用：

cargo build --release

產物路徑：

target/release/

release 模式會啟用優(yōu)化，運行性能明顯優(yōu)于 debug 模式。

九、配置 VS Code 開發(fā) Rust

9.1 安裝 VS Code 插件

Linux 桌面環(huán)境可以使用 VS Code 開發(fā) Rust，推薦插件：

9.2 推薦 settings.json

在項目中創(chuàng)建 .vscode/settings.json：

{
  "editor.formatOnSave": true,
  "rust-analyzer.check.command": "clippy",
  "rust-analyzer.cargo.features": "all",
  "files.trimTrailingWhitespace": true
}

這份配置會讓保存格式化和 Clippy 檢查更順手。

9.3 配置 LLDB 調試

安裝 CodeLLDB 后，可以創(chuàng)建 .vscode/launch.json：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "lldb",
      "request": "launch",
      "name": "Debug hello_rust",
      "cargo": {
        "args": ["build", "--bin=hello_rust"],
        "filter": {
          "name": "hello_rust",
          "kind": "bin"
        }
      },
      "args": [],
      "cwd": "${workspaceFolder}"
    }
  ]
}

注意把 hello_rust 改成自己的項目名。

十、終端與 Neovim 開發(fā)方案

10.1 純終端開發(fā)

如果你習慣終端開發(fā)，可以使用：

cargo check
cargo test
cargo run

cargo check 不生成最終二進制，檢查速度更快，適合頻繁驗證語法和類型。

10.2 Neovim + rust-analyzer

Neovim 用戶可以通過 LSP 接入 rust-analyzer。核心依賴是：

rustup component add rust-analyzer

如果發(fā)行版沒有直接提供 rust-analyzer，也可以讓編輯器插件自動下載。

10.3 常見終端輔助工具

可以額外安裝：

cargo install cargo-watch
cargo install cargo-edit

用途：

• cargo-watch：文件變化后自動執(zhí)行命令。
• cargo-edit：提供 cargo add、cargo rm 等依賴管理命令。

示例：

cargo watch -x check -x test

十一、Linux 常見問題與解決方案

11.1 cargo 命令不存在

原因通常是 ~/.cargo/bin 沒有加入 PATH。

處理方式：

source "$HOME/.cargo/env"
echo "$PATH"

如果使用 Bash：

echo 'source "$HOME/.cargo/env"' >> ~/.bashrc
source ~/.bashrc

11.2 編譯時報 cc not found

說明系統(tǒng)沒有安裝 C 編譯器。

Ubuntu/Debian：

sudo apt install -y build-essential

Fedora：

sudo dnf groupinstall -y "Development Tools"

Arch：

sudo pacman -S --needed base-devel

11.3 OpenSSL 編譯失敗

很多依賴會用到 OpenSSL。Ubuntu/Debian 安裝：

sudo apt install -y pkg-config libssl-dev

Fedora 安裝：

sudo dnf install -y pkg-config openssl-devel

Arch 安裝：

sudo pacman -S --needed pkgconf openssl

11.4 Cargo 下載依賴很慢

可以先開啟詳細日志：

cargo build -vv

如果卡在索引或下載階段，優(yōu)先配置 sparse 協(xié)議或國內鏡像。

11.5 rust-analyzer 不生效

排查順序：

1. 確認 VS Code 打開的是項目根目錄。
2. 確認根目錄存在 Cargo.toml。
3. 執(zhí)行 cargo check 看項目是否能通過基礎檢查。
4. 安裝 rust-src。
5. 重啟編輯器。

安裝命令：

rustup component add rust-src

十二、管理多個 Rust 工具鏈

12.1 查看工具鏈

rustup toolchain list

常見輸出：

stable-x86_64-unknown-linux-gnu (default)
nightly-x86_64-unknown-linux-gnu

12.2 安裝 nightly

某些實驗功能需要 nightly：

rustup toolchain install nightly

臨時使用 nightly：

cargo +nightly build

初學和生產項目仍然建議優(yōu)先使用 stable。

12.3 項目固定工具鏈

可以在項目根目錄創(chuàng)建 rust-toolchain.toml：

[toolchain]
channel = "stable"
components = ["rustfmt", "clippy", "rust-src"]
profile = "default"

團隊成員進入項目后會自動使用指定工具鏈。

十三、添加測試驗證環(huán)境

13.1 編寫一個簡單函數

修改 src/main.rs：

fn add(left: i32, right: i32) -> i32 {
    left + right
}

fn main() {
    println!("1 + 2 = {}", add(1, 2));
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn add_should_work() {
        assert_eq!(add(1, 2), 3);
    }
}

13.2 運行測試

cargo test

如果看到測試通過，說明 Rust 編譯、運行、測試鏈路都正常。

13.3 完整驗證腳本

可以把下面命令逐條執(zhí)行：

rustup --version
rustc --version
cargo --version
cargo new rust_env_check
cd rust_env_check
cargo run
cargo fmt
cargo clippy
cargo test

全部成功后，Linux Rust 環(huán)境就搭建完成了。

總結

Linux 下搭建 Rust 環(huán)境的核心步驟并不復雜：先安裝系統(tǒng)編譯依賴，再通過 rustup 安裝 Rust stable 工具鏈，隨后配置 Cargo 下載源，最后用 cargo new、cargo run、cargo test 做完整驗證。

如果你使用 Ubuntu、Debian、Fedora、Arch 或 openSUSE，本文都給出了對應依賴安裝命令。完成配置后，你就可以在 Linux 上使用 Rust 開發(fā)命令行工具、Web 服務、系統(tǒng)程序和高性能后端應用。

以上就是Linux系統(tǒng)下搭建Rust開發(fā)環(huán)境的詳細過程的詳細內容，更多關于Linux搭建Rust開發(fā)環(huán)境的資料請關注腳本之家其它相關文章！

最新評論