# 版本管理工具: rustup rustup 是rust官方的版本管理工具。 项目主页是: ## Features * 管理安装多个官方版本的 Rust 二进制程序。 * 配置基于目录的 Rust 工具链。 * 安装和更新来自 Rust 的发布通道: nightly, beta 和 stable。 * 接收来自发布通道更新的通知。 * 从官方安装历史版本的 nightly 工具链。 * 通过指定 stable 版本来安装。 * 安装额外的 std 用于交叉编译。 * 安装自定义的工具链。 * 独立每个安装的 Cargo metadata。 * 校验下载的 hash 值。 * 校验签名 (如果 GPG 存在)。 * 断点续传。 * 只依赖 bash, curl 和常见 unix 工具。 * 支持 Linux, OS X, Windows(via MSYS2)。 ## 安装 ### Windows 在[rustup的主页](http://www.rustup.rs)下载并运行rustup-init.exe,并按照提示选择选项。 在Windows下工具链会安装到`%USERPROFILE%\.cargo\bin`文件夹下并添加到`$PATH`环境变量。 ### Linux & OSX 运行以下命令 ``` curl https://sh.rustup.rs -sSf | sh ``` 这个命令将会编译和安装 rustup, 安装过程中可能会提示你输入 sudo 的密码。 然后, 他会下载和安装 stable 版本的工具链, 当执行 rustc, rustdoc 和 cargo 时, 将会配置他为默认工具链。 `Unix` 上安装后工具链会被安装到 `$HOME/.cargo/bin`目录。 `.cargo/bin`目录会被添加到系统的`$PATH`环境变量,重新登录后即可使用`rustc`，`cargo`等命令。 ## 卸载 ``` rustup self uninstall ``` ## 用法 安装后会得到一个 rustup 命令, 多使用命令自带的帮助提示, 可以快速定位你需要功能。 ### 帮助 运行 `rustup -h` 你将会得到如下提示: ``` ❯ rustup -h #rustup 0.1.12 (c6e430a 2016-05-12) #The Rust toolchain installer # #USAGE: # rustup [FLAGS] [SUBCOMMAND] # #FLAGS: # -v, --verbose Enable verbose output # -h, --help Prints help information # -V, --version Prints version information # #SUBCOMMANDS: # show Show the active and installed toolchains # update Update Rust toolchains # default Set the default toolchain # toolchain Modify or query the installed toolchains # target Modify a toolchain's supported targets # override Modify directory toolchain overrides # run Run a command with an environment configured for a given toolchain # which Display which binary will be run for a given command # doc Open the documentation for the current toolchain. # self Modify the rustup installation # telemetry rustup telemetry commands # help Prints this message or the help of the given subcommand(s) # #rustup installs The Rust Programming Language from the official #release channels, enabling you to easily switch between stable, beta, #and nightly compilers and keep them updated. It makes cross-compiling #simpler with binary builds of the standard library for common platforms. # #If you are new to Rust consider running `rustup doc --book` #to learn Rust. ``` 根据提示, 使用 `rust help ` 来查看子命令的帮助, 基本看这些帮助文档就足够了。 我们可以使用`rustup default ` 配置默认的工具链。 其中标准的 ``具有如下的形式 `[-][-]` ``` = stable|beta|nightly| = YYYY-MM-DD = ``` 如`stable-x86_64-pc-windows-msvc` `nightly-2014-12-18` `1.8.0`等都是合法的toolchain名称。 我们也可以采用[自定义toolchain](https://github.com/rust-lang-nursery/rustup.rs#working-with-custom-toolchains)配合rustup。 下面着重介绍几个常用的命令。 `rustup override add ` 添加一个目录以及其子目录的默认工具链。 `rustup override remove ` 删除一个目录以及其子目录的默认工具链。 `rustup show` 显示当前安装的工具链信息。 `rustup toolchain install ` 安装特定的的工具链。 `rustup toolchain link ""` 设置自定义工具链。 `rustup target add ` 设置工具链的可用目标。 `rustup update` 检查安装工具链的更新。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://yar999.gitbook.io/rustprimer/preface/rustup.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.