项目入门

本章目标是让你在 15 分钟内跑通 Roplat 的基础环境，并建立后续学习所需的最小上下文。

你需要准备什么

1. Rust 工具链（建议 nightly，与仓库保持一致）
2. C++ 编译器（Windows 下建议 MSVC）
3. Python（用于后续多语言扩展，不是第一步必需）
4. VS Code（推荐）

仓库结构速览

1. roplat：核心运行时（Node、Rhythm、通讯、类型绑定）
2. roplat_macros：过程宏（node、system、roplat_msg）
3. roplat_build：two-pass 构建编排与代码生成
4. examples/multi_lang：多语言示例（推荐新手第一实践）
5. roplat-pages：文档站点
6. roplat_rfc：设计讨论与规范草案

第一组命令（先验证内核）

cargo build -p roplat
cargo test -p roplat

如果通过，说明 Rust 侧基础功能可用。

第二组命令（再验证多语言链路）

cargo run -p multi_lang

这一步会触发 two-pass 生成流程并编译 C++ 桥接代码。

质量门禁（每次改动后都执行）

cargo clippy --workspace --all-targets -- -D warnings

Roplat 项目默认使用严格 lint，建议把它当成“提交前必过”。

推荐 VS Code 插件

1. Rust Analyzer
2. Error Lens
3. GitLens
4. Path Intellisense
5. Markdown All in One

下一步

完成本章后，继续阅读 设计思想。