Rust

fn mean(values: &[f64]) -> Option<f64> {
    (!values.is_empty()).then(|| values.iter().sum::<f64>() / values.len() as f64)
}

&[T] 借用连续数据且不取得所有权；空输入由 Option 显式表达。

fn load(path: &Path) -> Result<Config, Box<dyn Error>> {
    let text = fs::read_to_string(path)?;
    Ok(serde_json::from_str(&text)?)
}

? 会在错误时提前返回并转换兼容错误类型；库代码可使用更具体的错误枚举。

let total: i64 = rows
    .iter()
    .filter(|row| row.active)
    .map(|row| row.amount)
    .sum();

迭代器是惰性的；终止操作 sum/collect 才消费数据流。

// src/lib.rs
pub mod model;

// src/main.rs
fn main() -> anyhow::Result<()> {
    memory_lab::run()?;
    Ok(())
}

集成测试可以像外部用户一样导入 library crate。anyhow 适合应用层上下文，不是唯一方案。

[workspace]
resolver = "3"
members = ["crates/core", "crates/cli"]

多 crate 项目共享 Cargo.lock 与 target；依赖可在 workspace.dependencies 集中声明。

cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-features

CI 中把格式、lint 和测试分开显示，便于快速定位失败阶段。

cargo run -- --help
cargo build --release

-- 后的参数传给程序；release 产物通常位于 target/release。

cargo check --all-targets

不生成最终机器码，编辑循环中通常比完整 build 更快。

cargo add serde --features derive
cargo add --dev pretty_assertions

cargo add 更新 Cargo.toml 和 lockfile；dev-dependencies 只用于测试/开发。

cargo tree
cargo tree -d

-d 查找多版本依赖；不要仅为“版本统一”强行覆盖不兼容的主版本。

#[test]
fn rejects_empty_input() {
    assert_eq!(mean(&[]), None);
    assert_eq!(mean(&[2.0, 4.0, 6.0]), Some(4.0));
}

模块内单元测试可访问私有项；tests/ 中的集成测试只走公开 API。

cargo test rejects_empty_input -- --exact --nocapture
RUST_BACKTRACE=1 cargo test

PowerShell 可先设置 $env:RUST_BACKTRACE="1"；backtrace 需要调试信息。

rust-gdb target/debug/memory_lab
break memory_lab::main
run
bt

Windows/MSVC 工具链通常使用 Visual Studio 或兼容调试器。

找到取得所有权的调用 → 判断应传 &T、&mut T 还是返回所有权 → 仅在语义确需副本时 clone。

移动不是拷贝失败，而是编译器阻止重复使用已转移的所有权。

缩短不可变借用作用域；先提取所需值；避免同一时刻持有指向同一数据的可变与不可变引用。

通过重新组织作用域解决，而不是滥用内部可变性。

阅读 required by bound → 检查泛型参数与 feature → 用 cargo tree 确认是否存在不同版本的同名类型。

编译器的 help / note 往往给出缺失 trait 或派生建议。

let count: usize = raw
    .trim()
    .parse()
    .map_err(|_| AppError::InvalidCount)?;
if count > MAX_ITEMS { return Err(AppError::TooLarge); }

类型解析之后仍要验证业务上限，避免内存或计算量拒绝服务。

把 unsafe 限制在小模块；逐条写明 Safety 前置条件；外部提供安全 API；用测试/Miri/平台工具覆盖边界。

unsafe 关闭的是部分编译器检查，不等于代码自动正确。

审阅新增 crate、feature 与许可证；提交 Cargo.lock；定期更新并测试；可使用 cargo-audit 检查已知公告。

cargo-audit 需要单独安装，审计结果还需要结合可达性和运行环境判断。