单文档 vs 多文档设计

A. 单文档设计（Single-Document）

单文档设计：所有子系统在同一个文档中

优点

• 简单 — 所有内容在一个文档里，不需要在多个文档间切换
• 适合小团队 — 1-3 人的队伍管理起来很轻松
• 内部引用方便 — 同文档内的零件互相引用不需要跨文档操作

缺点

• 文件越大越慢 — 零件多了加载和操作会变慢
• 多人编辑时需要协调 — 虽然 Onshape 支持实时协作，但同一文档内的并发编辑需要默契
• 不适合非常复杂的机器人 — 超过几百个零件时可能卡顿

真实案例：FRC Basketball Robot

这是一个典型的单文档设计案例。所有子系统（Drivetrain、Intake 等）都在同一个文档的不同标签页中。

B. 多文档设计（Multi-Document）

多文档设计：每个子系统独立文档，总装配体引用各子文档

优点

• 每个子系统独立 — 修改底盘不会影响进球系统的文档
• 多人并行工作 — 不同的人负责不同的文档，互不干扰
• 加载更快 — 只打开需要的子系统文档

缺点

• 管理更复杂 — 需要维护多个文档之间的引用关系
• 命名规范要求高 — 文档多了之后，没有好的命名规范会很混乱
• 跨文档引用 — 需要理解 Onshape 的文档间引用机制

真实案例：PTC 多文档机器人项目

这个项目将机器人拆分成多个独立文档，每个子系统一个文档，最后在总装配中引用。

C. 选择建议

不管选哪种方式，最重要的是保持一致。中途切换组织方式的成本很高。在赛季开始时就和队友商量好，然后坚持到底。