toru3/rust

镜像概述

该Docker镜像旨在提供多版本、多通道的Rust开发环境，包含从1.31.1到1.68.0的稳定版本，以及官方stable（稳定版）、beta（测试版）、nightly（每日构建版）三个发布通道。镜像预装了rustfmt（Rust代码格式化工具）和clippy（Rust代码静态分析工具），可直接用于Rust项目的开发、构建、测试及代码质量控制。

核心功能与特性

• 多版本覆盖：支持Rust 1.31.1、1.32.0、...、1.68.0等历史稳定版本，满足不同项目对Rust版本的兼容性需求
• 全通道支持：提供stable（稳定版）、beta（测试版）、nightly（每日构建版）三个官方发布通道，支持尝鲜新特性或使用稳定环境
• 内置开发工具：集成rustfmt（代码格式化工具）和clippy（代码静态分析工具），无需额外安装即可进行代码规范化和质量检查
• 环境一致性：标准化Rust开发环境，避免因系统差异导致的编译或运行问题，确保跨平台构建一致性

使用场景

• 本地开发环境：快速搭建隔离的Rust开发环境，避免与系统全局环境冲突
• 多版本兼容性测试：验证项目在不同Rust版本下的编译和运行情况
• CI/CD流水线集成：作为自动化构建、测试、部署流程的基础环境，确保构建过程可重复
• 临时开发任务：无需在本地安装Rust，直接通过容器完成代码编写、编译和测试

使用方法与配置说明

镜像拉取

通过Docker命令拉取指定版本或通道的镜像，标签格式为[镜像仓库名]:[版本号]或[镜像仓库名]:[通道名]：

bash
# 拉取stable通道最新版本
docker pull [镜像仓库名]:stable

# 拉取特定版本（如1.68.0）
docker pull [镜像仓库名]:1.68.0

# 拉取beta通道
docker pull [镜像仓库名]:beta

# 拉取nightly通道
docker pull [镜像仓库名]:nightly

注：请将[镜像仓库名]替换为实际镜像仓库名称（如Docker Hub上的仓库名）

容器运行示例

1. 交互式开发环境

启动交互式容器，挂载本地项目目录，进行代码开发：

bash
# 使用stable版本，挂载当前项目目录到容器内/app目录
docker run -it --rm -v $(pwd):/app -w /app [镜像仓库名]:stable bash

进入容器后，可直接使用Rust工具链：

bash
# 检查Rust版本
rustc --version
# 初始化新项目
cargo new my_project
# 编译项目
cargo build
# 运行程序
cargo run

2. 非交互式构建

直接在容器内执行构建或测试命令，完成后自动退出容器：

bash
# 使用1.68.0版本构建release版本
docker run --rm -v $(pwd):/app -w /app [镜像仓库名]:1.68.0 cargo build --release

# 使用nightly通道运行clippy静态分析
docker run --rm -v $(pwd):/app -w /app [镜像仓库名]:nightly cargo clippy --all-targets

# 使用beta通道运行测试
docker run --rm -v $(pwd):/app -w /app [镜像仓库名]:beta cargo test

3. 代码格式化

使用内置的rustfmt工具格式化代码：

bash
# 格式化当前项目代码
docker run --rm -v $(pwd):/app -w /app [镜像仓库名]:stable cargo fmt

常用命令参考

容器内支持Rust官方工具链的所有标准命令：

• rustc：Rust编译器
• cargo：Rust包管理器（包含build、run、test、fmt、clippy等子命令）
• rustfmt：代码格式化工具（通过cargo fmt调用）
• clippy：代码静态分析工具（通过cargo clippy调用）