Debian 如何配置 Rust 多线程开发环境：从安装到跑通第一个示例

江岸

发布时间：2026-08-23 | 104人浏览过

原创

前言

想在 Debian 上开始写 Rust 多线程程序，真正需要处理的并不多：先把官方工具链装好，再确认 shell 能正确找到 `rustc` 和 `cargo`，最后用一个最小示例把线程跑起来。本文按“安装、验证、建项目、运行示例”的顺序整理流程，同时补充 Rust 并发学习里最容易卡住的核心概念，方便你判断环境是否已经配置到位。

想在 Debian 上开始写 Rust 多线程程序，真正需要处理的并不多：先把官方工具链装好，再确认 shell 能正确找到 rustc 和 cargo，最后用一个最小示例把线程跑起来。本文按“安装、验证、建项目、运行示例”的顺序整理流程，同时补充 Rust 并发学习里最容易卡住的核心概念，方便你判断环境是否已经配置到位。

安装 Rust 工具链

在 Debian 上，最省事的方式仍然是使用 Rust 官方提供的安装脚本。它会拉取并运行 rustup-init，把最新稳定版 Rust 以及常用配套工具一并装好，包括 rustc 和 cargo。

展示 Debian 上从安装 Rust 到运行多线程示例的步骤流程图 — **Rust 多线程环境配置流程**用一张流程图概括 Debian 上配置 Rust 多线程环境的最短路径。

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

如果这一步执行正常，后续的开发环境基础就已经具备了。对大多数 Debian 用户来说，用 rustup 管理工具链也更方便后续升级与切换版本。

配置 shell 环境变量

安装完成后，还需要让当前 shell 会话识别 Rust 工具链所在位置。对于 bash，可以直接执行下面这条命令：

source $HOME/.cargo/env

这一步的作用，是把 Cargo 的可执行文件路径加载进当前环境。若你平时使用的是 zsh 或其他 shell，建议把相同逻辑写入对应配置文件，例如 .zshrc，这样重新打开终端后就不必重复手动加载。

验证 Rust 是否安装成功

环境变量配置好后，先不要急着写代码，先确认编译器和包管理器都能正常调用。执行以下命令：

rustc --version
cargo --version

如果终端返回了各自的版本号，说明 rustc 和 cargo 已经处于可用状态。到这里，Debian 上的 Rust 开发基础环境就算搭好了。

用 Cargo 创建多线程示例项目

接下来可以直接新建一个项目，并进入项目目录：

cargo new my_multithreaded_project
cd my_multithreaded_project

使用 Cargo 建项目的好处是目录结构、构建配置和运行入口都会一次生成，适合后续继续添加依赖、拆分模块，或者扩展更复杂的并发实验代码。

编写第一个 Rust 多线程程序

打开 src/main.rs，写入一个最基础的线程示例。Rust 标准库中的 std::thread 模块已经提供了线程创建与管理能力，入门时先理解 spawn 和 join 的基本配合就够用了。

展示 Rust 基础线程示例中主线程与子线程的执行关系 — **主线程与子线程的执行关系**这张图对应最基础的线程示例，把 `spawn`、子线程执行、`join`。

use std::thread;

fn main() {
    let handle = thread::spawn(|| {
        // 这里是你想要在新线程中运行的代码
        println!("Hello from a thread!");
    });

    // 等待线程结束
    handle.join().unwrap();
    println!("Hello from the main thread!");
}

这段代码做了两件事：先通过 thread::spawn 启动一个新线程，再通过 handle.join().unwrap() 等待它执行完成。这样可以保证子线程输出结束后，主线程再继续往下运行。