工具链与调试

workspace 多 crate 布局、日常工具链（fmt/clippy/rust-analyzer）与调试排错入门。

Workspace：多 crate 布局

当一个项目长到「可执行程序 + 若干库 + 共享工具」时，用 workspace（工作区） 把它们放进同一个仓库、共享一个 Cargo.lock 与一个 target/。好处：一次 cargo build 编译全部成员；成员之间用路径依赖，改代码立即生效；依赖版本统一解析，不会出现同一 crate 的多个版本。

toml

# 根 Cargo.toml：只有 [workspace]，它自己不是一个包
[workspace]
resolver = "3"                  # edition 2024 对应 resolver 3；显式写出避免歧义
members = [
    "crates/core",              # 库：核心逻辑
    "crates/cli",               # 二进制：命令行入口
]

# 统一声明依赖版本：成员里写 serde.workspace = true 即可继承
[workspace.dependencies]
serde = { version = "1", features = ["derive"] }
anyhow = "1"

# workspace 级别的 lint，所有成员继承（成员也可再加自己的 [lints]）
[workspace.lints.rust]
unsafe_code = "forbid"

# 整个 workspace 共用的构建配置
[profile.release]
lto = "thin"

toml

# crates/cli/Cargo.toml：成员清单
[package]
name = "my-cli"
version = "0.1.0"
edition = "2024"

[dependencies]
# 路径依赖：指向 workspace 内的兄弟 crate
my-core = { path = "../core" }
# 继承 workspace 的统一版本声明
serde.workspace = true
anyhow.workspace = true

# 继承 workspace 的 lint 配置
[lints]
workspace = true

text

my-workspace/
├── Cargo.toml            # 根：只有 [workspace]
├── Cargo.lock            # 整个 workspace 共用一份
├── target/               # 整个 workspace 共用一份
└── crates/
    ├── core/
    │   ├── Cargo.toml
    │   └── src/lib.rs
    └── cli/
        ├── Cargo.toml
        └── src/main.rs

常用命令：

powershell

cargo build                          # 构建 workspace 全部成员
cargo run -p my-cli                  # 指定包（-p/--package）运行
cargo run -p my-cli -- --verbose     # -- 之后的参数给程序
cargo test -p my-core                # 只测某个成员
cargo check --workspace --all-targets # 检查所有成员的所有目标（含测试/示例）
cargo tree -p my-cli                 # 看某个成员的依赖树

⚠️ 陷阱：workspace 根目录下的 cargo run 如果唯一成员含多个 bin，cargo 会要求你用 -p 或 --bin 指明目标；报错信息通常是 error: could not determine which binary to run. Use the "--bin" option to specify a binary。

开发工具链：格式化、检查、编辑器、文档

`rustfmt`：唯一的格式

Rust 生态的基本共识是不争论格式，全交给 rustfmt。

powershell

cargo fmt                    # 就地格式化整个 crate
cargo fmt -- --check         # 只检查不修改：CI 里用，有差异就失败
cargo fmt -- --edition 2024  # 显式指定版次（一般由 Cargo.toml 自动带入）
rustfmt src/main.rs          # 直接格式化单文件（会就地覆盖）

项目级配置放 rustfmt.toml（或在 Cargo.toml 里写 [workspace.metadata.rustfmt] 不再推荐）：

toml

# rustfmt.toml：注意 max_width 必须与团队约定一致，否则 diff 会很吵
max_width = 100
tab_spaces = 4
edition = "2024"
newline_style = "Windows"          # Windows 上避免整文件行尾变化
use_field_init_shorthand = true

⚠️ 陷阱：rustfmt.toml 里有些选项属于 unstable，只有在 nightly 工具链下才生效，stable 会静默忽略它们。想让 CI 稳定，就只用稳定选项，或者全团队统一 rust-toolchain.toml。

`clippy`：几百条经验规则

clippy 是官方 lint 工具，能发现「能编译但写得不地道/有性能坑」的代码，例如 &String 参数应该用 &str、if let 可以简化、循环可以换成迭代器、clone() 多余等。

powershell

cargo clippy                                    # 跑默认 lint（clippy::all 的 warn 子集）
cargo clippy --all-targets -- -D warnings       # 覆盖测试/示例，并把警告升级为错误（CI 标准）
cargo clippy --fix --allow-dirty                # 自动应用可机器修复的建议
cargo clippy -- -W clippy::pedantic             # 打开更严格的 pedantic 组（会有很多噪音）

💡 对照：clippy ≈ Python 的 ruff/pylint、JS 的 eslint、Java 的 SpotBugs，但它是官方随工具链分发的，不需要额外选型。第一次跑 clippy 通常会有几十条建议，建议按 -D warnings 逐条处理。

`rust-analyzer` 与 VS Code 配置

rust-analyzer 是官方的语言服务器（language server，LSP 实现），提供补全、跳转、内联类型提示、错误实时标记。VS Code 安装扩展 rust-analyzer 市场页（官方维护；也可在扩展面板里搜 rust-analyzer 直接安装）。

.vscode/settings.json 推荐配置：

json

{
  // 保存时用 rust-analyzer 的格式化（内部也调用 rustfmt），而不是 VS Code 默认格式化器
  "editor.formatOnSave": true,
  "[rust]": {
    "editor.defaultFormatter": "rust-lang.rust-analyzer"
  },
  // 保存时自动应用 clippy 建议的快速修复，能省掉大量手工调整
  "rust-analyzer.check.command": "clippy",
  "rust-analyzer.check.extraArgs": ["--all-targets"],
  // 显示内联类型提示（对零基础读者理解类型推断帮助很大）
  "rust-analyzer.inlayHints.typeHints.enable": true,
  "rust-analyzer.inlayHints.parameterHints.enable": true,
  // 排除 target/，避免 VS Code 文件监视器被构建产物拖慢
  "files.watcherExclude": {
    "**/target/**": true
  }
}

若希望「保存即检查」而不想装扩展的自动行为，也可以用命令行持续检查：

powershell

cargo watch -x clippy            # 需要先 cargo install cargo-watch

文档：`cargo doc` 与离线手册

powershell

cargo doc                     # 为当前 crate 及其依赖生成 HTML 文档，输出到 target/doc/
cargo doc --open              # 生成后自动打开浏览器（Windows 默认浏览器）
cargo doc --no-deps           # 只给自己的 crate 生成，快很多
cargo doc --document-private-items   # 连私有项也生成（内部项目适用）
rustup doc                    # 打开本地离线标准库文档（无需联网）
rustup doc --std              # 直接跳到 std 文档
rustup doc --book             # 打开官方《The Rust Programming Language》离线版

文档注释用 ///（外层，写在使用者看得到的地方）与 //!（内层，写在模块/crate 顶部）：

rust

//! 这个库把温度换算相关的工具集中在一起。
//! 模块级文档写在文件顶部，用 //! 而不是 ///。

/// 把摄氏度换算为华氏度。
///
/// # 示例
///
/// ```
/// assert_eq!(my_lib::celsius_to_fahrenheit(0.0), 32.0);
/// ```
///
/// 代码块会被 `cargo test` 当作 doctest 编译并执行——文档即测试。
pub fn celsius_to_fahrenheit(c: f64) -> f64 {
    c * 9.0 / 5.0 + 32.0
}

`cargo install`：装命令行工具

cargo install 从 crates.io 下载源码并在本地编译安装到 %CARGO_HOME%\bin （默认即 %USERPROFILE%\.cargo\bin），因此机器上需要有可用的 MSVC 链接器。

powershell

# cargo-edit：提供 cargo add / rm / upgrade（cargo 1.62+ 已内置 add/rm，upgrade 仍需它）
cargo install cargo-edit

# cargo-watch：文件变更后自动重跑指定命令
cargo install cargo-watch
cargo watch -x run                     # 每次保存自动 cargo run
cargo watch -x check -x test           # 依次执行 check 与 test

# cargo-expand：展开宏（println!、derive、async 等）看真实生成的代码
cargo install cargo-expand
cargo expand                           # 打印 main.rs 宏展开后的完整代码

# cargo-binstall：优先下载预编译二进制，避免每次现场编译（省时间）
cargo install cargo-binstall

cargo install --list                   # 查看已安装的工具
cargo uninstall cargo-watch            # 卸载

🚀 进阶：cargo install 装的工具与项目依赖是两套东西：前者的版本不受你项目的 Cargo.lock 约束。想固定团队工具版本，用 cargo install --locked cargo-watch 加上版本号，或者用 cargo-binstall（第三方，描述为「下载预编译 Rust 二进制」）统一安装。

调试与排错入门

`dbg!`：比 `println!` 更好用的临时探针

dbg! 会打印表达式源码、值和外层文件名行号，并把值原样返回，因此可以内联进表达式：

rust

fn main() {
    let a = 2;
    let b = dbg!(a * 3) + 1;   // 打印 [src/main.rs:3:13] a * 3 = 6，然后返回 6 继续参与运算
    dbg!(a, b);                // 一次打印多个值，输出到标准错误（stderr）
    println!("a={a}, b={b}");
}

输出（stderr，实际路径以你的工程为准）：
text
[src/main.rs:3:13] a * 3 = 6
[src/main.rs:4:5] a = 2
[src/main.rs:4:5] b = 7
然后 stdout 输出：a=2, b=7

⚠️ 陷阱：dbg! 输出到 stderr，println! 输出到 stdout。用 cargo run > out.txt 重定向时看不到 dbg!；dbg! 是临时探针，交付前必须删干净（用 [lints.clippy] dbg_macro = "warn" 兜底）。

`println!` 的 `{:?}` 与 `{:#?}`

{} 走 Display（面向用户的格式），{:?} 走 Debug（面向开发者的格式），{:#?} 是 Debug 的多行美化版：

rust

// 演示 Debug 格式：结构体加 derive 才能用 {:?}
#[derive(Debug)]
struct User {
    name: String,
    age: u8,
}

fn main() {
    let u = User { name: "Alice".to_string(), age: 30 };
    println!("{}", u.age);      // Display：整数可用
    println!("{:?}", u);        // 单行 Debug
    println!("{:#?}", u);       // 多行美化 Debug，排查嵌套结构最舒服
    // 自己实现展示格式时用 Display，见〈集合与迭代器〉 trait 部分
}

输出：

text

30
User { name: "Alice", age: 30 }
User {
    name: "Alice",
    age: 30,
}

🧠 原理：{:?} 之所以需要 #[derive(Debug)]，是因为 Debug 是一个 trait，而 Rust 不提供「反射式默认打印」——没有实现就没有方法可调用。derive 宏在编译期生成实现代码，零运行期开销。

panic 与 `RUST_BACKTRACE`

panic 是「不可恢复错误」：默认行为是展开栈（unwind）并结束当前线程，进程退出码 101。 panic 消息包含「位置 + 原因 + 提示」，读法是：先看第一行位置，再看第二行原因。

rust

fn main() {
    let v = vec![1, 2, 3];
    // 索引越界在运行期 panic；想避免就用 v.get(5) 返回 Option<&i32>
    println!("{}", v[5]);
}

典型输出（注意 thread 'main' (PID) 中的线程 id 是平台相关的）：
text
thread 'main' (18944) panicked at src\main.rs:3:19:
index out of bounds: the len is 3 but the index is 5
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

打开回溯（PowerShell 与 bash 的写法不同，注意这是环境变量不是 cargo 参数）：

powershell

# PowerShell：用 $env: 前缀，作用范围是当前会话及其子进程
$env:RUST_BACKTRACE = 1
cargo run

# 只看自己的栈帧，屏蔽标准库内部噪声（更常用）
$env:RUST_BACKTRACE = "full"
cargo run

# 用完清掉，避免影响后续判断
Remove-Item Env:\RUST_BACKTRACE

bash

# bash / zsh 里的等价写法（Git Bash、WSL 适用）
export RUST_BACKTRACE=1
cargo run
unset RUST_BACKTRACE

输出（打开后多了 stack backtrace: 段，帧号从内到外）：
text
stack backtrace:
   0: std::panicking::panic_handler
   1: core::panicking::panic_fmt
   2: core::panicking::panic_bounds_check
   ...

💡 对照：RUST_BACKTRACE=1 ≈ Python 的 traceback（但 Python 默认就打印）、Java 的异常栈；区别是 Rust 只有在 panic 时才需要它，正常错误（Result）不产生栈。

怎么读 `cargo build` 的报错

以最常见的一类错误为例（把整数赋给 String）：

rust

fn main() {
    let s: String = 42;      // E0308：类型不匹配
    println!("{s}");
}

text

error[E0308]: mismatched types
 --> src\main.rs:2:21
  |
2 |     let s: String = 42;
  |            ------   ^^ expected `String`, found integer
  |            |
  |            expected due to this
  |
help: try using a conversion method
  |
2 |     let s: String = 42.to_string();
  |                       ++++++++++++

For more information about this error, try `rustc --explain E0308`.
error: could not compile `my_app` (bin "my_app") due to 1 previous error

读报错的四步法：

error[E0308]：错误码，rustc --explain E0308 会给出长篇官方解释与正反例。
--> src\main.rs:2:21：文件:行:列，直接用 Ctrl+P 跳过去。
箭头指示：^^ 指向「出问题的表达式」，------ 指向「产生期望值的地方」。
help:：通常是编译器给出的可直接照抄的修复方案（这里直接给出 42.to_string()）。

warning 与 error 的区别：warning 不阻止编译，但不要习惯性忽略；cargo clippy -- -D warnings 会在 CI 里把它们变成错误。

与其他语言的对照表

同一件事在五种技术栈里的对应关系（Rust 一列是本章主角）：

关注点	Python	Node	Java	Go	Rust（Cargo）
包管理	`pip install`	`npm install`	Maven 坐标	`go get`	`cargo add`（内置）
依赖清单	`pyproject.toml`	`package.json`	`pom.xml`	`go.mod`	`Cargo.toml`
构建 / 运行	`poetry run`	`node app.js`	`mvn package`	`go run`	`cargo run`
快速类型检查	`mypy`（外部）	`tsc --noEmit`	`javac` 本身就是	`go vet`	`cargo check`（内置）
测试	`pytest`（外部）	`jest`（外部）	JUnit（外部）	`go test`（内置）	`cargo test`（内置）
格式化	`ruff format`（外部）	`prettier`（外部）	`google-java-format`	`gofmt`（内置）	`cargo fmt`（官方）
静态检查	`ruff`（外部）	`eslint`（外部）	SpotBugs（外部）	`go vet`（内置）	`cargo clippy`（官方）
文档生成	`sphinx`（外部）	`typedoc`（外部）	`javadoc`（内置）	`go doc`（内置）	`cargo doc`（内置）
REPL / 交互	`ipython`	`node` REPL	`jshell`	无官方 REPL	无 REPL，用官方 Playground
依赖锁文件	`poetry.lock`	`package-lock.json`	版本写死在清单	`go.sum`	`Cargo.lock`
安装全局 CLI	`pipx install`	`npm i -g`	无统一方式	`go install`	`cargo install`
依赖缓存	`~/.cache/pip`	`node_modules/`	`~/.m2`	`$GOPATH/pkg/mod`	`%CARGO_HOME%`
试验场	`python`	`node`	`jshell`	—	Playground

💡 对照要点：Cargo 是这些工具里一体化程度最高的一个——包管理、构建、测试、格式化、静态检查、文档全都在一条命令空间下，且格式化/检查/文档都是官方组件，不需要社区选型。代价是「Rust 只有一种主流做法」，灵活性换来了统一性。

常见坑

`link.exe not found`

text

error: linker `link.exe` not found
  |
  = note: program not found
note: the msvc targets depend on the Visual Studio build tools for linking.
      Please make sure that the Visual Studio build tools are installed.

原因：x86_64-pc-windows-msvc 目标需要 MSVC 的 link.exe；只装了 rustup，没装 C++ 生成工具。
修法：winget install Microsoft.VisualStudio.2022.BuildTools，安装时勾选「使用 C++ 的桌面开发」，然后新开终端（VS 环境的 LIB/PATH 需要重新加载）。
替代路线：rustup toolchain install stable-x86_64-pc-windows-gnu + rustup default stable-gnu，走 MinGW 链接器（需要 MinGW-w64 在 PATH 中）。除非有特别理由，优先 MSVC：与 Windows 系统库、 MSVC 编译的第三方库兼容性最好。

中文路径、用户名与空格

历史上 rustc 在非 ASCII 路径上偶有构建脚本、链接器相关的问题；建议把工作区放在纯 ASCII 的简短路径（如 D:\rust），属于安全选择。
路径含空格时，某些自建 build.rs / 第三方构建脚本容易失败。若必须放在 C:\Users\张三\我的文档\Rust 学习 这类路径下，出问题时可先用 subst 建一个无空格盘符验证：

powershell

# 把带空格/中文的项目目录映射成 Z:，用 Z: 路径编译以排除路径因素
subst Z: "C:\Users\张三\我的文档\Rust 学习"
cd Z:\my_app
cargo build
subst Z: /d        # 验证完删除映射

`cargo` 下载慢 / 卡在 `Updating crates.io index`

原因：crates.io 的索引与包体在境外，国内直连经常超时或极慢。

修法：使用稀疏索引（sparse registry）镜像。配置文件位置（二选一）：项目级 <项目>/.cargo/config.toml，或用户级 %USERPROFILE%\.cargo\config.toml （自定义过 CARGO_HOME 时则是 %CARGO_HOME%\.cargo\config.toml）。

toml

# ~/.cargo/config.toml：用稀疏索引替换 crates.io 源，只影响本机，不进版本库
[source.crates-io]
replace-with = "rsproxy-sparse"

[source.rsproxy-sparse]
registry = "sparse+https://rsproxy.cn/index/"

[registries.rsproxy]
index = "sparse+https://rsproxy.cn/index/"

[net]
git-fetch-with-cli = true     # 用系统 git 拉 git 依赖，能顺带用上系统代理
retry = 3

其他常用镜像（写法相同，把 registry 一行换掉即可）：

镜像	`registry` 值
rsproxy（字节）	`sparse+https://rsproxy.cn/index/`
中科大 USTC	`sparse+https://mirrors.ustc.edu.cn/crates.io-index/`
上海交大 SJTU	`sparse+https://mirror.sjtu.edu.cn/crates.io-index/`

⚠️ 陷阱与注意事项：
source.crates-io 的替换是全局的，会让 Cargo.lock 里记录的下载地址指向镜像。团队协作时要么全员配同一镜像，要么只在本地配（~/.cargo/config.toml 天然不进仓库，最稳妥）。
必须用 sparse+ 前缀。旧的 git 协议索引已不推荐，首次同步会非常慢。
镜像同步有延迟，刚发布的版本可能还查不到；cargo add 报「找不到包」时先换回官方源确认。
[source] 替换不会覆盖 [patch]、git 依赖、私有 registry，这些仍走原地址。
只加镜像不一定够：若公司在代理后，还要设 HTTPS_PROXY / HTTP_PROXY 环境变量，或按 Cargo 官方 config 文档（官方，config 全部字段与优先级）配置 [http] proxy。

Windows Defender 拖慢 `target/`

实时防护会扫描每次写入的 .rlib / .exe / .pdb，大型项目 cargo build 可能慢 2~5 倍。

推荐：把项目目录（至少 <项目>/target）加入「排除项」。图形界面路径：设置 → 隐私和安全性 → Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 排除项 → 添加文件夹。
也可用管理员 PowerShell 添加：

powershell

Add-MpPreference -ExclusionPath 'D:\rust\my_app'

替代方案：把 CARGO_TARGET_DIR 指到已排除的目录，例如 D:\cargo-target：

powershell

# 只对当前会话生效；也可写进系统环境变量长期生效
$env:CARGO_TARGET_DIR = 'D:\cargo-target'

PowerShell 特有的坑

现象	原因	修法
`cargo run` 成功但程序实际失败	`$?` 只看 PowerShell 状态，不看原生退出码	改用 `$LASTEXITCODE` 判断
管道过滤后拿不到退出码	管道把结果变成对象流，`$LASTEXITCODE` 不可靠	先落盘再过滤：`cargo test *> log.txt`
`case` 用不了	PowerShell 没有 `case`，分支语句叫 `switch`	`switch ($x) { 'a' { } default { } }`
`\|` 的行为与 bash 不同	传的是对象不是文本，文本管道思维失效	用 `Select-String` / `Where-Object`
引号与转义不同	反引号 ` 是转义符，双引号内 `$` 会被插值	正则 / 路径含 `$` 时用单引号 `'...'`
`&&` / `\|\|` 不可用	Windows PowerShell 5.1 不支持，7+ 才支持	用 `;` 与 `if ($?)`，或升级到 PowerShell 7
`rustc main.rs` 报找不到文件	当前目录不是文件所在目录	先 `Set-Location`，或确认 `Get-ChildItem` 能看到

多个 rustc 版本互相打架

症状：rustc --version 与 cargo --version 报的版本不一致；编辑器报「找不到 std」；明明升级了工具链却还在用旧版。

查清当前生效的是谁：

powershell

Get-Command rustc | Select-Object Source      # 实际的 exe 路径
rustup show                                   # 当前目录生效的工具链及原因
rustup which rustc                            # rustup 认为该用哪个 rustc
$env:PATH -split ';' | Select-String cargo    # PATH 里是否有多个 cargo bin 目录

常见原因：
1. 以前用 MSI 装过 Rust（非 rustup），C:\Program Files\Rust\bin 之类目录在 PATH 里排在 rustup 代理前面 → 卸载旧安装，确保 %CARGO_HOME%\bin 靠前。
2. 在某个项目目录里放了 rust-toolchain.toml，进入该目录后自动切换工具链——这是预期行为，不是 bug；rustup show 会明确写 active because: directory override。
3. IDE 自己配了「Rust 工具链路径」而没跟随 rustup → 在 VS Code 里清空 rust-analyzer.cargo.extraEnv / 工具链覆盖，让它用 rustup which 的结果。
4. 手工改过 PATH 后没有重开终端。
修法：统一用 rustup 管理，删掉其他来源的 rustc；需要版本差异时不要改全局默认，改用 rustup run <toolchain> cargo build 或项目里的 rust-toolchain.toml。

速查表

需求	命令 / 配置	备注
查版本	`rustc --version` / `cargo --version`	本章基准均为 1.98.1
看工具链全貌	`rustup show`	默认宿主、已装工具链、当前生效工具链与原因
装组件	`rustup component add rustfmt clippy rust-analyzer`	组件属于某个工具链
换工具链	`rustup default nightly` / `rustup run nightly cargo build`	前者改全局，后者只影响一条命令
建工程	`cargo new my_app --bin` / `--lib`	`--vcs none` 跳过 Git 初始化
开发循环	`cargo check` → `cargo run`	check 不生成机器码，最快
发布构建	`cargo build --release`	产物在 `target/release/`
清缓存	`cargo clean`	删整个 `target/`；`cargo clean -p my_app` 只清一个包
加依赖	`cargo add rand` / `cargo add tokio -F full`	自动选版本并写清单
看依赖树	`cargo tree` / `cargo tree -d`	`-d` 找重复版本
锁定依赖	`cargo update` / `cargo build --locked`	lock 记录精确版本
格式化	`cargo fmt` / `cargo fmt -- --check`	配置放 `rustfmt.toml`
静态检查	`cargo clippy --all-targets -- -D warnings`	CI 标准写法
文档	`cargo doc --open` / `rustup doc`	后者是离线标准库手册
装工具	`cargo install cargo-watch` / `cargo expand`	装到 `%CARGO_HOME%\bin`
Debug 打印	`dbg!(x)` / `println!("{:#?}", x)`	`dbg!` 输出到 stderr
打开回溯	`$env:RUST_BACKTRACE=1`	PowerShell 写法；bash 用 `export`
指定成员	`cargo run -p my-cli`	workspace 专用
传参给程序	`cargo run -- --name Rust`	`--` 必须有

学习路线与环境准备

环境搭建与工具链

变量与流程控制

所有权与借用

结构体、枚举与 trait

集合与迭代器

错误处理

泛型与生命周期

智能指针与闭包

并发编程

异步编程

宏与元编程

工程化与常用 crate

测试、性能与 unsafe

工具链与调试

Workspace：多 crate 布局

开发工具链：格式化、检查、编辑器、文档

`rustfmt`：唯一的格式

`clippy`：几百条经验规则

`rust-analyzer` 与 VS Code 配置

文档：`cargo doc` 与离线手册

`cargo install`：装命令行工具

调试与排错入门

`dbg!`：比 `println!` 更好用的临时探针

`println!` 的 `{:?}` 与 `{:#?}`

panic 与 `RUST_BACKTRACE`

怎么读 `cargo build` 的报错

与其他语言的对照表

常见坑

`link.exe not found`

中文路径、用户名与空格

`cargo` 下载慢 / 卡在 `Updating crates.io index`

Windows Defender 拖慢 `target/`

PowerShell 特有的坑

多个 rustc 版本互相打架

速查表

工具链与调试 ​

Workspace：多 crate 布局 ​

开发工具链：格式化、检查、编辑器、文档 ​

rustfmt：唯一的格式 ​

clippy：几百条经验规则 ​

rust-analyzer 与 VS Code 配置 ​

文档：cargo doc 与离线手册 ​

cargo install：装命令行工具 ​

调试与排错入门 ​

dbg!：比 println! 更好用的临时探针 ​

println! 的 {:?} 与 {:#?} ​

panic 与 RUST_BACKTRACE ​

怎么读 cargo build 的报错 ​

与其他语言的对照表 ​

常见坑 ​

link.exe not found ​

中文路径、用户名与空格 ​

cargo 下载慢 / 卡在 Updating crates.io index ​

Windows Defender 拖慢 target/ ​

PowerShell 特有的坑 ​

多个 rustc 版本互相打架 ​

速查表 ​

工具链与调试

Workspace：多 crate 布局

开发工具链：格式化、检查、编辑器、文档

`rustfmt`：唯一的格式

`clippy`：几百条经验规则

`rust-analyzer` 与 VS Code 配置

文档：`cargo doc` 与离线手册

`cargo install`：装命令行工具

调试与排错入门

`dbg!`：比 `println!` 更好用的临时探针

`println!` 的 `{:?}` 与 `{:#?}`

panic 与 `RUST_BACKTRACE`

怎么读 `cargo build` 的报错

与其他语言的对照表

常见坑

`link.exe not found`

中文路径、用户名与空格

`cargo` 下载慢 / 卡在 `Updating crates.io index`

Windows Defender 拖慢 `target/`

PowerShell 特有的坑

多个 rustc 版本互相打架

速查表