Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions pages.zh/common/rustup-check.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# rustup check

> 检查 Rust 工具链和 `rustup` 的更新。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 检查所有更新:

`rustup check`
8 changes: 8 additions & 0 deletions pages.zh/common/rustup-completions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# rustup completions

> 为 `rustup` 和 `cargo` 生成命令补全脚本。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 将补全脚本输出到 `stdout`:

`rustup completions {{bash|elvish|fish|powershell|zsh}} {{rustup|cargo}}`
21 changes: 21 additions & 0 deletions pages.zh/common/rustup-component.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# rustup component

> 修改已安装工具链的组件。
> 如果不使用 `--toolchain` 选项,`rustup` 将使用默认工具链。有关工具链的更多信息请参见 `rustup help toolchain`。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 向工具链添加组件:

`rustup component add --toolchain {{工具链}} {{组件}}`

- 从工具链中移除组件:

`rustup component remove --toolchain {{工具链}} {{组件}}`

- 列出工具链已安装和可用的组件:

`rustup component list --toolchain {{工具链}}`

- 列出工具链已安装的组件:

`rustup component list --toolchain {{工具链}} --installed`
8 changes: 8 additions & 0 deletions pages.zh/common/rustup-default.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# rustup default

> 设置默认 Rust 工具链。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 切换默认 Rust 工具链(详见 `rustup help toolchain`):

`rustup default {{工具链}}`
25 changes: 25 additions & 0 deletions pages.zh/common/rustup-doc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# rustup doc

> 打开当前工具链的离线 Rust 文档。
> 这里没有列出所有文档页面。有关更多信息请参见 `rustup help doc`。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 打开主页:

`rustup doc`

- 打开特定主题的文档(标准库中的模块、类型、关键字等):

`rustup doc {{std::fs|usize|fn|...}}`

- 打开 the Rust Programming Language book:

`rustup doc --book`

- 打开 the Cargo book:

`rustup doc --cargo`

- 打开 the Rust Reference:

`rustup doc --reference`
12 changes: 12 additions & 0 deletions pages.zh/common/rustup-help.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# rustup help

> 显示 `rustup` 及其子命令的帮助信息。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 显示帮助:

`rustup help`

- 显示子命令的帮助信息:

`rustup help {{子命令}}`
32 changes: 32 additions & 0 deletions pages.zh/common/rustup-init.sh.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# rustup-init.sh

> 用于安装 `rustup` 和 Rust 工具链的脚本。
> 更多信息:<https://forge.rust-lang.org/infra/other-installation-methods.html#rustup>.

- 下载并运行 `rustup-init` 来安装 `rustup` 和默认 Rust 工具链:

`curl https://sh.rustup.rs {{[-sSf|--silent --show-error --fail]}} | sh -s`

- 下载并运行 `rustup-init` 并传递参数:

`curl https://sh.rustup.rs {{[-sSf|--silent --show-error --fail]}} | sh -s -- {{参数}}`

- 运行 `rustup-init` 并指定要安装的额外组件或目标:

`rustup-init.sh --target {{目标}} --component {{组件}}`

- 运行 `rustup-init` 并指定要安装的默认工具链:

`rustup-init.sh --default-toolchain {{工具链}}`

- 运行 `rustup-init` 并不安装任何工具链:

`rustup-init.sh --default-toolchain {{none}}`

- 运行 `rustup-init` 并指定安装配置文件:

`rustup-init.sh --profile {{minimal|default|complete}}`

- 运行 `rustup-init` 并跳过确认提示:

`rustup-init.sh -y`
7 changes: 7 additions & 0 deletions pages.zh/common/rustup-install.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# rustup install

> 该命令是 `rustup toolchain install` 的别名。

- 查看原命令的文档:

`tldr rustup toolchain`
12 changes: 12 additions & 0 deletions pages.zh/common/rustup-man.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# rustup man

> 查看由 `rustup` 管理的命令的 man 手册页。
> 更多信息:<https://rust-lang.github.io/rustup/examples.html>.

- 查看默认工具链中某个命令的 man 手册页:

`rustup man {{命令}}`

- 查看指定工具链中某个命令的 man 手册页:

`rustup man --toolchain {{工具链}} {{命令}}`
21 changes: 21 additions & 0 deletions pages.zh/common/rustup-override.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# rustup override

> 修改目录的工具链覆盖设置。
> 有关工具链的更多信息,请参见 `rustup help toolchain`。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 列出目录的工具链覆盖设置:

`rustup override list`

- 为当前目录设置覆盖工具链(即在该目录中运行 `cargo`、`rustc` 等命令时使用指定工具链):

`rustup override set {{工具链}}`

- 移除当前目录的工具链覆盖设置:

`rustup override unset`

- 移除所有指向已不存在目录的工具链覆盖设置:

`rustup override unset --nonexistent`
9 changes: 9 additions & 0 deletions pages.zh/common/rustup-run.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# rustup run

> 在指定 Rust 工具链环境下运行命令。
> 注意:所有由 rustup 管理的命令都有简写形式,例如,`cargo +nightly build` 等价于 `rustup run nightly cargo build`。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 使用指定的 Rust 工具链运行命令(有关工具链的更多信息,请参见 `rustup help toolchain`):

`rustup run {{工具链}} {{命令}}`
12 changes: 12 additions & 0 deletions pages.zh/common/rustup-self.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# rustup self

> 管理 `rustup` 本身的安装。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 更新 `rustup`:

`rustup self update`

- 卸载 `rustup`:

`rustup self uninstall`
16 changes: 16 additions & 0 deletions pages.zh/common/rustup-set.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# rustup set

> 修改 `rustup` 的配置。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 设置默认目标平台:

`rustup set default-host {{目标平台}}`

- 设置默认安装配置(`minimal` 只包含 `rustc`、`rust-std` 和 `cargo`,而 `default` 还会安装 `rust-docs`、`rustfmt` 和 `clippy`):

`rustup set profile {{minimal|default}}`

- 设置在执行 `rustup update` 时是否自动更新 `rustup` 本身:

`rustup set auto-self-update {{enable|disable|check-only}}`
16 changes: 16 additions & 0 deletions pages.zh/common/rustup-show.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# rustup show

> 显示已安装的工具链、目标平台以及 `rustc` 的版本信息。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 显示所有信息:

`rustup show`

- 显示当前激活的工具链:

`rustup show active-toolchain`

- 显示 rustup 数据目录:

`rustup show home`
21 changes: 21 additions & 0 deletions pages.zh/common/rustup-target.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# rustup target

> 修改工具链支持的目标平台。
> 如果不使用 `--toolchain` 选项,`rustup` 会使用默认工具链。更多信息请参见 `rustup help toolchain`。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 为工具链添加目标平台:

`rustup target add --toolchain {{工具链}} {{目标}}`

- 从工具链移除目标平台:

`rustup target remove --toolchain {{工具链}} {{目标}}`

- 列出工具链的可用目标平台和已安装目标平台:

`rustup target list --toolchain {{工具链}}`

- 列出工具链已安装的目标平台:

`rustup target list --toolchain {{工具链}} --installed`
21 changes: 21 additions & 0 deletions pages.zh/common/rustup-toolchain.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
# rustup toolchain

> 管理 Rust 工具链。
> 有关工具链的更多信息,请参见 `rustup help toolchain`。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 安装或更新指定工具链:

`rustup toolchain install {{工具链}}`

- 卸载工具链:

`rustup toolchain uninstall {{工具链}}`

- 列出已安装的工具链:

`rustup toolchain list`

- 通过创建符号链接来创建自定义工具链:

`rustup toolchain link {{自定义工具链名称}} {{path/to/directory}}`
7 changes: 7 additions & 0 deletions pages.zh/common/rustup-uninstall.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# rustup uninstall

> 该命令是 `rustup toolchain uninstall` 的别名。

- 查看原命令的文档:

`tldr rustup toolchain`
12 changes: 12 additions & 0 deletions pages.zh/common/rustup-update.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# rustup update

> 更新 Rust 工具链以及 `rustup` 本身(如果不是通过包管理器安装的)
> 更多信息:<https://rust-lang.github.io/rustup>.

- 更新所有已安装的工具链和 `rustup`:

`rustup update`

- 安装或更新指定工具链(有关工具链的更多信息,请参见 `rustup help toolchain`):

`rustup update {{工具链}}`
13 changes: 13 additions & 0 deletions pages.zh/common/rustup-which.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# rustup which

> 显示 `rustup` 管理的命令将运行哪个二进制文件。
> 类似 `which` 命令,但搜索的是 Rust 工具链而不是 `$PATH`。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 显示默认工具链中命令的二进制文件路径:

`rustup which {{命令}}`

- 显示指定工具链中命令的二进制文件路径(有关工具链的更多信息,请参见 `rustup help toolchain`):

`rustup which --toolchain {{工具链}} {{命令}}`
33 changes: 33 additions & 0 deletions pages.zh/common/rustup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# rustup

> 安装、管理和更新 Rust 工具链。
> 一些子命令,如 `toolchain`、`target`、`update` 等有自己的使用文档。
> 更多信息:<https://rust-lang.github.io/rustup>.

- 为你的系统安装 nightly 工具链:

`rustup install nightly`

- 将默认工具链切换为 nightly 以便 `cargo` 和 `rustc` 命令使用它:

`rustup default nightly`

- 在当前项目中使用 nightly 工具链,但保持全局设置不变:

`rustup override set nightly`

- 更新所有工具链:

`rustup update`

- 列出已安装的工具链:

`rustup show`

- 使用指定工具链运行 `cargo build`:

`rustup run {{工具链}} cargo build`

- 在默认网页浏览器中打开本地 Rust 文档:

`rustup doc`