asset-light Docs

Rust 学习指南（结合 asset-light 项目）

目标读者

你熟悉 JS/TS/Java 前后端技术栈，但第一次系统学习 Rust，并希望通过 asset-light 这个真实项目建立 Rust 心智模型、掌握工程化工作流与常见库（Dioxus、rusqlite、serde、chrono、uuid、rust_decimal 等）。

使用方式（推荐）

• 每章 30-90 分钟：先读“概念与对照”，再做“本项目练习”。
• 边读边改：学习 Rust 最有效的方式是不断经历「编译器报错 → 理解原因 → 修正设计」。
• 以小步提交为节奏：每次只做一个小改动，保证能 cargo check 通过（或至少明确当前失败原因）。

章节目录（循序渐进）

1. 学习路线与心智模型（从 JS/Java 到 Rust）
   • 01-roadmap-and-mental-model.md
2. 工具链与 Cargo 工作流（你每天会用到的命令）
   • 02-toolchain-and-cargo.md
3. crate / module / 可见性（看懂项目结构与 mod）
   • 03-crate-modules-and-visibility.md
4. 所有权与借用（Rust 的“语法税”从哪里来）
   • 04-ownership-and-borrowing.md
5. 数据建模：struct / enum / derive / Option（结合本项目模型）
   • 05-data-modeling.md
6. 错误处理：Result / ? / thiserror（让代码可维护）
   • 06-error-handling.md
7. SQLite 与 rusqlite：Repository 模式与类型转换
   • 07-sqlite-and-rusqlite.md
8. Dioxus 入门：组件、props、Signal、路由与数据流
   • 08-dioxus-ui-and-state.md
9. 练习清单与进阶路线（把 Rust 用熟）
   • 09-exercises-and-next-steps.md

你会在这个项目里学到什么（按能力分层）

• 语言层：所有权/借用、pattern matching、trait 的基本用法、Option/Result、宏（derive）。
• 工程层：Cargo 工作流、模块边界、错误类型设计、单元测试/集成测试思路。
• 项目层：本地 SQLite、Repository、Dioxus UI、全局状态与数据加载策略。

推荐的“最小跑通”验证

• 能 cargo run 启动桌面应用。
• 能在“资产管理”新增一条资产，刷新列表并落库。
• 能发起一次盘点并在“历史”看到快照。
• 能在“配置”切换激活方案，并在“首页”看到偏离提示变化。