Rustup

Rustup 是 Rust 编程语言的工具链管理器,用于安装、更新和管理 Rust 版本、组件和目标平台。它支持丰富的命令行选项,允许开发者轻松切换工具链和配置环境。本教程基于官方文档和社区资源,提供超级扩展的指导,分为50个独立教程部分,每个部分聚焦一个关键命令或选项组合使用场景。每个教程包括:

  • 描述:命令的功能说明。
  • 语法:基本命令格式。
  • 示例:实际命令和预期效果(假设已安装 rustup)。
  • 高级提示:扩展用法或注意事项。

这些教程从基础开始,逐步深入,适合初学者到高级用户。安装 rustup 后,直接在终端运行 rustup 即可开始实验。注意:这些命令通常全局运行,不限于项目目录。

教程1: 获取帮助信息 (--help)

描述:显示 rustup 的所有命令和简要说明,帮助快速上手。
语法rustup --helprustup help <command>
示例
rustup --help
输出:列出所有子命令,如 toolchaintarget 等。
高级提示rustup help toolchain 获取特定子命令的详细帮助。

教程2: 查看版本信息 (--version)

描述:打印当前 rustup 版本,便于检查兼容性。
语法rustup --versionrustup version
示例
rustup --version
输出:rustup 1.27.1 (2024-04-29)(版本依安装而定)。
高级提示:结合 --verboserustup --version --verbose 获取更多细节。

教程3: 安装工具链 (toolchain install)

描述:安装指定的 Rust 工具链版本。
语法rustup toolchain install <toolchain>
示例
rustup toolchain install stable
安装稳定版工具链。
高级提示rustup toolchain install nightly --allow-downgrade 允许降级安装。

教程4: 列出工具链 (toolchain list)

描述:列出已安装的工具链。
语法rustup toolchain list
示例
rustup toolchain list
输出:如 stable-x86_64-unknown-linux-gnu (default)
高级提示rustup toolchain list --verbose 显示路径。

教程5: 更新工具链 (update)

描述:更新已安装的工具链到最新版本。
语法rustup update
示例
rustup update
更新所有工具链。
高级提示rustup update stable 更新特定工具链。

教程6: 卸载工具链 (toolchain uninstall)

描述:移除指定的工具链。
语法rustup toolchain uninstall <toolchain>
示例
rustup toolchain uninstall beta
移除 beta 版。
高级提示:小心使用,避免移除默认工具链。

教程7: 设置默认工具链 (default)

描述:设置全局默认工具链。
语法rustup default <toolchain>
示例
rustup default stable
将稳定版设为默认。
高级提示rustup default nightly 切换到 nightly。

教程8: 添加目标平台 (target add)

描述:为当前工具链添加交叉编译目标。
语法rustup target add <target>
示例
rustup target add wasm32-unknown-unknown
添加 WebAssembly 目标。
高级提示rustup target add --toolchain nightly 指定工具链。

教程9: 移除目标平台 (target remove)

描述:移除指定的目标平台。
语法rustup target remove <target>
示例
rustup target remove arm-unknown-linux-gnueabihf
移除 ARM 目标。
高级提示:检查 rustup target list 先确认。

教程10: 列出目标平台 (target list)

描述:列出可用和已安装的目标平台。
语法rustup target list
示例
rustup target list
输出:可用目标列表。
高级提示rustup target list --installed 只显示已安装。

教程11: 添加组件 (component add)

描述:为工具链添加组件,如 rustfmt。
语法rustup component add <component>
示例
rustup component add clippy
添加 Clippy lint 工具。
高级提示rustup component add --toolchain stable rust-src 添加源代码。

教程12: 移除组件 (component remove)

描述:移除指定的组件。
语法rustup component remove <component>
示例
rustup component remove rls
移除 RLS。
高级提示:节省空间时使用。

教程13: 列出组件 (component list)

描述:列出可用和已安装的组件。
语法rustup component list
示例
rustup component list
输出:组件列表。
高级提示rustup component list --installed 只显示已安装。

教程14: 设置目录覆盖 (override set)

描述:为当前目录设置工具链覆盖。
语法rustup override set <toolchain>
示例
rustup override set nightly
当前目录使用 nightly。
高级提示:用于项目特定版本。

教程15: 移除目录覆盖 (override unset)

描述:移除当前目录的工具链覆盖。
语法rustup override unset
示例
rustup override unset
恢复全局默认。
高级提示rustup override list 检查覆盖。

教程16: 运行命令 (run)

描述:使用指定工具链运行命令。
语法rustup run <toolchain> <command>
示例
rustup run stable cargo build
使用 stable 运行 cargo。
高级提示:临时切换工具链。

教程17: 查找二进制路径 (which)

描述:显示指定二进制的路径。
语法rustup which <command>
示例
rustup which rustc
输出 rustc 路径。
高级提示rustup which --toolchain nightly rustc 指定工具链。

教程18: 显示信息 (show)

描述:显示当前工具链和覆盖信息。
语法rustup show
示例
rustup show
输出活跃工具链。
高级提示rustup show active-toolchain 只显示活跃。

教程19: 打开文档 (doc)

描述:打开 Rust 文档。
语法rustup doc
示例
rustup doc
在浏览器打开 std 文档。
高级提示rustup doc --book 打开 The Book。

教程20: 打开手册 (man)

描述:显示 Rust 工具的手册页。
语法rustup man <command>
示例
rustup man rustc
显示 rustc 手册。
高级提示:需安装 man 组件。

教程21: 自更新 (self update)

描述:更新 rustup 本身。
语法rustup self update
示例
rustup self update
更新到最新 rustup。
高级提示:定期运行保持最新。

教程22: 自卸载 (self uninstall)

描述:卸载 rustup 和所有工具链。
语法rustup self uninstall
示例
rustup self uninstall
移除一切。
高级提示:确认前备份。

教程23: 遥测启用 (telemetry enable)

描述:启用 rustup 遥测。
语法rustup telemetry enable
示例
rustup telemetry enable
开始收集数据。
高级提示:用于贡献社区。

教程24: 遥测禁用 (telemetry disable)

描述:禁用 rustup 遥测。
语法rustup telemetry disable
示例
rustup telemetry disable
停止收集。
高级提示:隐私优先。

教程25: 转储测试 (dump-testament)

描述:转储 rustup 测试文件。
语法rustup dump-testament
示例
rustup dump-testament
输出 JSON 测试。
高级提示:开发使用。

教程26: 详细模式 (--verbose / -v)

描述:启用详细输出。
语法rustup -v <command>
示例
rustup -v update
显示详细更新过程。
高级提示:调试问题时使用。

教程27: 安静模式 (--quiet / -q)

描述:抑制非错误输出。
语法rustup -q <command>
示例
rustup -q install stable
安静安装。
高级提示:脚本中使用。

教程28: 指定配置文件 (--config)

描述:使用自定义配置文件。
语法rustup --config <file> <command>
示例
rustup --config custom.toml install stable
使用自定义 config。
高级提示:自定义设置。

描述:链接自定义工具链。
语法rustup toolchain link <name> <path>
示例
rustup toolchain link custom /path/to/rust
链接自定义构建。
高级提示:用于自编译 Rust。

教程30: 工具链移除 (toolchain remove)

描述:别名卸载工具链。
语法rustup toolchain remove <toolchain>
示例
rustup toolchain remove stable
移除稳定版。
高级提示:与 uninstall 同。

教程31: 目标安装 (target install)

描述:别名添加目标。
语法rustup target install <target>
示例
rustup target install x86_64-apple-darwin
安装目标。
高级提示:交叉编译。

教程32: 组件安装 (component install)

描述:别名添加组件。
语法rustup component install <component>
示例
rustup component install rustfmt
安装格式化工具。
高级提示:IDE 集成。

教程33: 覆盖列表 (override list)

描述:列出所有覆盖。
语法rustup override list
示例
rustup override list
显示目录覆盖。
高级提示:管理多项目。

教程34: 显示首页 (show home)

描述:显示 Rust 安装目录。
语法rustup show home
示例
rustup show home
输出 ~/.rustup。
高级提示:自定义 RUSTUP_HOME。

教程35: 显示工具链 (show toolchain)

描述:显示活跃工具链。
语法rustup show toolchain
示例
rustup show toolchain
输出当前工具链。
高级提示:脚本中使用。

教程36: 文档主题 (doc --std)

描述:打开标准库文档。
语法rustup doc --std
示例
rustup doc --std
打开 std 文档。
高级提示:离线浏览。

教程37: 自升级 (self upgrade)

描述:升级 rustup。
语法rustup self upgrade
示例
rustup self upgrade
升级到最新。
高级提示:与 update 同。

教程38: 遥测分析 (telemetry analyze)

描述:分析遥测数据。
语法rustup telemetry analyze
示例
rustup telemetry analyze
显示统计。
高级提示:开发工具。

教程39: 安装 nightly (toolchain install nightly)

描述:安装 nightly 工具链。
语法rustup toolchain install nightly
示例
rustup toolchain install nightly
安装实验版。
高级提示:测试新特性。

教程40: 更新所有 (update --force)

描述:强制更新工具链。
语法rustup update --force
示例
rustup update --force
强制刷新。
高级提示:解决缓存问题。

教程41: 组件 rust-analyzer (component add rust-analyzer)

描述:添加 rust-analyzer 组件。
语法rustup component add rust-analyzer
示例
rustup component add rust-analyzer
用于 LSP。
高级提示:VS Code 集成。

教程42: 目标 wasm (target add wasm32-wasi)

描述:添加 WASI 目标。
语法rustup target add wasm32-wasi
示例
rustup target add wasm32-wasi
WebAssembly 系统接口。
高级提示:Web 开发。

教程43: 运行 rustc (run stable rustc)

描述:运行特定 rustc。
语法rustup run stable rustc hello.rs
示例
rustup run stable rustc hello.rs
编译文件。
高级提示:测试版本差异。

教程44: 显示 profile (show profile)

描述:显示当前 profile。
语法rustup show profile
示例
rustup show profile
输出 minimal/default 等。
高级提示:自定义安装。

教程45: 设置 profile (set profile)

描述:设置默认安装 profile。
语法rustup set profile <profile>
示例
rustup set profile minimal
最小安装。
高级提示:节省空间。

教程46: 代理设置 (proxy)

描述:设置代理工具链。
语法rustup proxy <toolchain>
示例
rustup proxy stable
代理执行。
高级提示:高级使用。

教程47: 环境变量 (RUSTUP_TOOLCHAIN)

描述:使用环境变量指定工具链。
语法RUSTUP_TOOLCHAIN=stable cargo build
示例
RUSTUP_TOOLCHAIN=stable cargo build
临时指定。
高级提示:脚本自动化。

教程48: 自定义镜像 (RUSTUP_DIST_SERVER)

描述:设置自定义分发服务器。
语法export RUSTUP_DIST_SERVER=https://mirror
示例
export RUSTUP_DIST_SERVER=https://mirror.rust-lang.org
自定义镜像。
高级提示:加速下载。

教程49: 禁用更新检查 (RUSTUP_UPDATE_ROOT)

描述:自定义更新根。
语法export RUSTUP_UPDATE_ROOT=https://custom
示例
export RUSTUP_UPDATE_ROOT=https://custom
自定义更新。
高级提示:企业环境。

教程50: 离线安装 (--no-self-update)

描述:安装时禁用自更新。
语法rustup toolchain install stable --no-self-update
示例
rustup toolchain install stable --no-self-update
避免更新 rustup。
高级提示:离线场景。