dimforge/parry

说明与用途

**项目简介**
dimforge / parry 是用 Rust 编写的 2D/3D 碰撞检测库，提供高精度的形状相交、射线投射、接触点生成等核心算法，适合游戏、仿真和实时物理系统。

**价值**

• **性能与安全**：基于 Rust 的零成本抽象和所有权系统，运行时几乎没有 GC 开销，且在编译期即可捕获大多数内存安全问题。
• **完整的几何支持**：内置球体、立方体、胶囊、凸多边形/多面体、网格等常用形状，支持层次包围体（BVH）加速大规模碰撞查询。
• **灵活的 API**：既可以直接使用高层函数进行“一键”碰撞检测，也可以自行构建 Collider、BroadPhase、NarrowPhase 组合，实现自定义的碰撞过滤和事件回调。

**典型接入方式**

1. **依赖声明**：在 Cargo.toml 中加入

   [dependencies]
   parry = "0.13"

1. **创建形状并进行查询**：

   use parry3d::shape::{Cuboid, Shape};
   use parry3d::query::intersection_test;

   let a = Cuboid::new(Vector::new(1.0, 1.0, 1.0));
   let b = Cuboid::new(Vector::new(0.5, 0.5, 0.5));

   // 位姿使用 Isometry（位置+旋转）
   let pos_a = Isometry::identity();
   let pos_b = Isometry::translation(0.8, 0.0, 0.0);

   let collides = intersection_test(&pos_a, &a, &pos_b, &b);
   println!("是否相交: {}", collides);

1. **大规模碰撞**：如果需要对成千上万的对象进行快速粗筛，可使用 BoundingVolumeHierarchy（BVH）或 SpatialHash，配合 BroadPhase / NarrowPhase 的组合模式。官方示例和 parry2d/parry3d 的文档提供了完整的工作流示例。

**生产可用性**

• **成熟度**：已有 800+ ⭐、140+ forks，最近一次提交在 2026‑05‑12，活跃度良好，表明社区仍在维护。
• **适用场景**：非常适合内部原型、工具链或对性能要求高的游戏/仿真模块；在对安全性有严格要求的 Rust 项目中尤为匹配。
• **风险与准备**：库本身提供的 API 完整，但集成路径（如与物理引擎、渲染系统的协同）在元数据中描述有限，建议在引入前：

1. **评估依赖树**：确认与现有项目的 Rust 版本兼容，检查是否有冲突的 nalgebra/glam 版本。
2. **编写小型验证用例**：验证形状创建、BVH 更新、并发查询等关键路径是否满足性能预期。
3. **监控维护状态**：关注仓库的 Issue 与 PR 活动，确保出现关键 bug 时能得到及时响应。

综上，parry 在性能、安全性和功能完整性方面具备中等到高的生产就绪度，适合作为内部或面向特定业务的碰撞检测核心，只需在正式上线前完成一次集成验证即可。

实际用途

dimforge/parry may be useful when its README and activity match a concrete workflow.

限制与审查说明

Medium: useful for prototypes or internal workflows, with dependency and maintenance checks before production.