名称：m11-生态系统 描述：“当集成crate或处理生态系统问题时使用。关键词：E0425, E0433, E0603, crate, cargo, 依赖, 特性标志, 工作空间, 使用哪个crate, 使用外部C库, 创建Python扩展, PyO3, wasm, WebAssembly, bindgen, cbindgen, napi-rs, 找不到, 私有, crate推荐, 最佳crate, Cargo.toml, 特性, crate 推荐, 依赖管理, 特性标志, 工作空间, Python绑定” 用户可调用：false
当前依赖项（自动注入）
!grep -A 100 '^\[dependencies\]' Cargo.toml 2>/dev/null | head -30 || echo "未找到Cargo.toml"
生态系统集成
第二层：设计选择
核心问题
什么才是适合这项工作的crate，以及应该如何集成？
添加依赖项之前：
- 是否有标准解决方案？
- 维护状态如何？
- API稳定性如何？
集成决策 → 实现
| 需求 | 选择 | Crates |
|---|---|---|
| 序列化 | 基于派生 | serde, serde_json |
| 异步运行时 | tokio 或 async-std | tokio（最流行） |
| HTTP客户端 | 人性化 | reqwest |
| HTTP服务器 | 现代化 | axum, actix-web |
| 数据库 | SQL 或 ORM | sqlx, diesel |
| CLI解析 | 基于派生 | clap |
| 错误处理 | 应用 vs 库 | anyhow, thiserror |
| 日志记录 | 门面模式 | tracing, log |
思考提示
添加依赖项之前：
-
维护是否良好？
- 最近有提交吗？
- 问题响应是否积极？
- 破坏性变更的频率？
-
范围是什么？
- 你需要整个crate还是仅需一个特性？
- 特性标志能否减少臃肿？
-
如何集成？
- 基于trait还是具体类型？
- 同步还是异步？
- 它需要什么约束？
向上追溯 ↑
到领域约束（第三层）：
"我应该使用哪个HTTP框架？"
↑ 询问：性能要求是什么？
↑ 检查：domain-web（延迟、吞吐量需求）
↑ 检查：团队专长（对框架的熟悉程度）
| 问题 | 追溯到 | 询问 |
|---|---|---|
| 框架选择 | domain-* | 哪些约束重要？ |
| 库 vs 构建 | domain-* | 部署模型是什么？ |
| API设计 | domain-* | 消费者是谁？ |
向下追溯 ↓
到实现（第一层）：
"集成外部crate"
↓ m04-zero-cost: Trait约束和泛型
↓ m06-error-handling: 错误类型兼容性
"FFI集成"
↓ unsafe-checker: 安全性要求
↓ m12-lifecycle: 资源清理
快速参考
语言互操作
| 集成 | Crate/工具 | 用例 |
|---|---|---|
| C/C++ → Rust | bindgen |
自动生成绑定 |
| Rust → C | cbindgen |
导出C头文件 |
| Python ↔ Rust | pyo3 |
Python扩展 |
| Node.js ↔ Rust | napi-rs |
Node插件 |
| WebAssembly | wasm-bindgen |
浏览器/WASI |
Cargo特性
| 特性 | 目的 |
|---|---|
[features] |
可选功能 |
default = [...] |
默认特性 |
feature = "serde" |
条件依赖 |
[workspace] |
多crate项目 |
错误代码参考
| 错误 | 原因 | 修复 |
|---|---|---|
| E0433 | 找不到crate | 添加到Cargo.toml |
| E0603 | 私有项 | 检查crate文档 |
| 特性未启用 | 可选特性 | 在features中启用 |
| 版本冲突 | 不兼容的依赖 | cargo update 或固定版本 |
| 重复类型 | 不同的crate版本 | 在工作空间中统一 |
Crate选择标准
| 标准 | 好迹象 | 警告迹象 |
|---|---|---|
| 维护 | 最近有提交 | 多年不活跃 |
| 社区 | 活跃的问题/PR | 无响应 |
| 文档 | 示例、API文档 | 文档极少 |
| 稳定性 | 语义化版本控制 | 频繁的破坏性变更 |
| 依赖项 | 最少、知名 | 繁重、晦涩 |
反模式
| 反模式 | 为什么不好 | 更好的做法 |
|---|---|---|
extern crate |
已过时（2018+） | 直接use |
#[macro_use] |
全局污染 | 显式导入 |
通配符依赖* |
不可预测 | 指定版本 |
| 依赖过多 | 供应链风险 | 评估必要性 |
| 打包所有依赖 | 维护负担 | 信任crates.io |
相关技能
| 何时 | 参见 |
|---|---|
| 错误类型设计 | m06-error-handling |
| Trait集成 | m04-zero-cost |
| FFI安全性 | unsafe-checker |
| 资源管理 | m12-lifecycle |