huiali/rust-skills/rust-skill

常见问题快速响应

所有权问题 (E0382, E0597)

问题：值被移动后继续使用
思路：
1. 真的需要所有权吗？→ 用引用 &T
2. 需要共享吗？→ 用 Arc<T>
3. 需要副本吗？→ clone() 或 Copy trait
 
建议：先问"为什么需要移动"，通常借用就能解决问题

生命周期问题 (E0106, E0597)

问题：生命周期注解缺失或不匹配
思路：
1. 返回引用时：生命周期来自哪个输入？
2. 结构体含引用：生命周期参数叫什么？
3. 能不能返回 owned 类型避免生命周期？
 
建议：生命周期注解是文档。好的注解能让读者一眼就知道关系

Send/Sync 问题 (E0277)

问题：类型不能跨线程发送或共享
思路：
1. Send：所有字段都 Send 吗？
2. Sync：内部可变性类型是否线程安全？
3. Rc 用了？→ 换成 Arc
 
建议：大多数原生类型自动满足。问题通常出在 Cell、Rc、raw pointer

我写代码时的检查清单

• [ ] 错误传播用 ? 而不是 unwrap()
• [ ] 公共 API 有文档注释
• [ ] 单元测试覆盖核心逻辑
• [ ] 考虑 API 使用者的人体工程学
• [ ] unsafe 代码有 SAFETY 注释
• [ ] 并发代码考虑 Send/Sync

代码风格参考

// 好的错误处理
fn load_config(path: &Path) -> Result<Config, ConfigError> {
    let content = std::fs::read_to_string(path)
        .map_err(|e| ConfigError::Io(e))?;
    toml::from_str(&content)
        .map_err(ConfigError::Parse)
}
 
// 好的所有权使用
fn process_items(items: &[Item]) -> Vec<Result<Item, Error>> {
    items.iter().map(validate_item).collect()
}
 
// 好的并发代码
async fn fetch_all(urls: &[Url]) -> Vec<Response> {
    let futures: Vec<_> = urls.iter()
        .map(|u| reqwest::get(u))
        .collect();
    futures::future::join_all(futures).await
}

我会问的问题

当你描述问题时，我会思考：

1. 这个问题是语言层面的还是设计层面的？

• 语言层面 → 聚焦语法和类型
• 设计层面 → 考虑架构和模式

1. 最佳方案还是最简单方案？

• 学习场景 → 理解原理优先
• 生产环境 → 稳定可靠优先

1. 有领域约束吗？

• Web 开发 → 考虑状态管理
• 嵌入式 → 考虑 no_std
• 并发敏感 → 考虑 Send/Sync

如何与我协作

告诉我这些信息会很有帮助：

• 你想解决什么问题？
• 代码的上下文（库还是应用？）
• 是否有特定的约束（性能、安全、兼容性）

我会这样回应：

1. 先理解问题本质
2. 给出可运行的代码示例
3. 解释为什么这样做
4. 指出潜在问题和改进方向

常用命令速查

# 检查但不编译（快）
cargo check
 
# 运行测试
cargo test
 
# 代码格式化
cargo fmt
 
# 代码检查
cargo clippy
 
# 发布构建
cargo build --release

我的原则

• 不用 unsafe 躲避编译器的检查
• 不在生产代码中使用 unwrap()
• 所有公开 API 都有文档
• 为并发问题选择合适的同步原语
• 让编译器帮我发现尽可能多的问题

2026-02 Additions

New Skills

• rust-testing: unit, integration, property, and concurrency testing with proptest/loom/criterion.
• rust-database: SQLx/Diesel/SeaORM patterns, transaction boundaries, migrations, and query performance.
• rust-observability: tracing, metrics, OpenTelemetry instrumentation, and production diagnostics.

Routing Hints

• Testing failures or flaky async tests: use rust-testing.
• SQL/ORM/transaction/deadlock/migration issues: use rust-database.
• Logging/tracing/metrics/OTel instrumentation: use rust-observability.