Overview

Command Line Interface

rustup

Rust的安裝工具，可以協助管理不同版本的rust。類似Python的pyenv或Node的nvm/fnm，但是是Rust官方的東西

檢視類命令

rustup show 顯示目前啟用中的rust

rustup check 檢查有沒有更新版的rust version

rustup toolchain list 列出所有已安裝的rust version

rustup which rustc 查目前啟用中的rustc location

rustup which cargo 查目前啟用中的cargo location

rustup component list 列出目前已安裝的components

查詢類命令

rust target 列出可以用rustup安裝的版本

安裝｀更新命令

rustup toolchain install [--allow-downgrade] [-t <target>]

rustc

rustc 編譯器

rustdoc

rustdoc 文件產生工具。在Rust source code內寫comment，用rustdoc轉成HTML文件

cargo

編譯管理器與套件管理器

cargo new <ProjectName> 建立新的Rust project

cargo run 編譯Cargo專案並執行

cargo build 編出來的binary會放在./target/debug/下

cargo clean

Switch build target

(以M1 Mac為例，build出x86)

1. rustup target list 列出可用的target

2. rustup target add x86_64-apple-darwin --toolchain stable 加入target給特定toolchain，此例為stable

3. 編輯~/.cargo，加入

[build]
target = x86_64-apple-darwin

之後的cargo build命令就會build出指定平台的binary

ENV Variables

RUSTUP_HOME 指向rustup管理與安裝rust的目錄，預設是~/.rustup

CARGO_HOME 指向cargo管理與安裝package的Toolchain目錄，預設是~/.cargo