PROGRESS.md

教程创建与增强进度

总体状态

• 开始时间: 2026-06-05
• 第一轮完成: 2026-06-05 (28 章 + 5 项目 + 10 根级文档)
• 第二轮增强: 2026-06-05 (C/C++ 对照 + 思维模型 + 误解审查)
• Rust 版本: 1.96.0 stable
• 目标: 面向 Python + C/C++ 基础学习者，提供系统化的 Rust 教学

第二轮增强内容 (2026-06-05)

新增根级文档

• C_CPP_TO_RUST.md — C/C++ → Rust 系统概念对照 (8 大主题，含表格)
• MENTAL_MODELS.md — 9 个核心思维模型 (变量绑定、所有权、借用、生命周期等)
• MISCONCEPTIONS.md — 25 条常见误解澄清

根级文档更新

• README.md — 更新面向人群、推荐阅读顺序、目录结构
• COURSE_MAP.md — 标注最高难度章节，新增文档入口
• LEARNING_GUIDE.md — 新增 C/C++ 学习者提醒
• GLOSSARY.md — 补充 C/C++ 术语对照说明表
• PROGRESS.md — 本文件更新

章节增强 (C/C++ 对照)

• 00_course_orientation — Python/C/C++/Rust 定位对照表
• 01_hello_cargo — Cargo 与 C/C++ 构建工具对照
• 02_variables_and_types — 变量、类型、char、数组对照
• 03_functions_expressions_control_flow — 表达式导向 vs 语句导向
• 04_stack_heap_and_raii — C malloc/C++ RAII/Rust 所有权对照流程图
• 05_ownership_move_copy_clone — Rust Move vs C++ Move 专节
• 06_references_borrowing_slices — 指针/引用对照表、NLL 时间线
• 08_structs_methods — struct+impl vs class 对照
• 09_enums_option_pattern_matching — 空指针问题、match 穷尽性
• 10_collections — UTF-8 字符串背景、字符串接口表
• 12_error_handling — C errno/C++ 异常/Python 异常/Rust Result
• 13_packages_modules — use vs #include、模块概念对照表
• 15_generics_traits — 泛型/模板对照、选择表
• 16_lifetimes — "先别害怕生命周期"、修复优先级
• 17_trait_objects — 虚函数/vtable 背景、静态/动态分派
• 18_closures_iterators — Python/C++ 迭代器对照
• 19_smart_pointers — 决策树、C++ 智能指针对照
• 20_resource_management — C/C++ Drop 对照
• 21_threads_concurrency — Send/Sync、类型对照表
• 22_async_await — asyncio/Future 对照、异步 vs 多线程
• 24_unsafe_ffi — unsafe 能力表、FFI 注意事项
• 25_cargo_features — Feature 是编译期选择

练习增强

• 11 个重点章节新增"迁移思维练习" (2-4 题/章)

练习答案 (2026-06-05 第三轮)

• 28 个章节全部编写 SOLUTIONS.md（含完整设计分析、参考代码、常见错误）
• 5 个综合项目全部编写 SOLUTIONS.md（含需求拆分、设计决策、关键模式）
• 11 个重点章节 SOLUTIONS.md 由仅含迁移练习扩展为完整答案
• 新增 22 个章节/项目的 SOLUTIONS.md
• 答案总规模 ~470KB
• 全部答案通过 scripts/audit_solutions.py 审核
• 全部工作区通过 fmt/check/test/clippy/doc 验证

综合项目增强

• 5 个项目 README 新增"迁移设计差异"小节

交叉链接

• 章节间相关链接 (04→05→06, 15→16→17, 19→20→21 等)

阶段进度 (第一轮)

Phase 1: 根结构 ✓

• 目录结构
• Cargo.toml (Virtual Workspace)
• rust-toolchain.toml
• .gitignore
• broken_examples/README.md
• scripts/check_all.sh
• scripts/check_all.ps1

Phase 2-4: 全部 28 章节 ✓

• 00-27 全部创建、编译通过、测试通过

Phase 5: 综合项目 ✓

• P01-P05 全部创建、编译通过、测试通过

Phase 6: 根级文档 ✓

• 14 个根级文档 (含第二轮新增 3 个)

Phase 7: 全量验收

• cargo fmt --all -- --check
• cargo check --workspace --all-targets
• cargo test --workspace
• cargo clippy --workspace --all-targets --all-features -- -D warnings
• cargo doc --workspace --no-deps

Final Release Audit (2026-06-05)

• 教程目录盘点 — 28 章 + 5 项目，0 缺失
• 练习与答案逐题映射 — 292 题全部有答案，0 漏题
• 答案质量复核 — 11 个核心章节深度审查通过
• 核心难点复核 — 11 项关键概念全部表述正确
• Python、C、C++ 对照复核 — 0 处误导表述
• README、题目、答案与源码一致性检查 — 通过
• Markdown 内部链接检查 — 493 个内部链接，0 断链 (修复 43 个)
• P03/P04/P05 补充 EXERCISES.md — 3 个缺失已补齐
• Workspace 格式化检查 — 通过
• Workspace 编译检查 — 通过
• Workspace 测试 — 全部通过 (含 doc tests)
• Clippy — 通过 (-D warnings)
• Rustdoc — 通过 (-D warnings)
• 最终发布报告 — FINAL_RELEASE_REPORT.md
• 发布冻结标记 — RELEASE_FREEZE.md

最终结论: PASS ✅