# Vector3::Project

```cpp
static Vector3 Project(const Vector3& vector, const Vector3& onNormal)
```

将向量投影到法线向量上。

**参数：**
- `vector` - 要投影的向量
- `onNormal` - 投影到的法线向量

**返回：** `Vector3` - 投影结果。如果法线长度为 0，返回零向量。

**线程安全：** ✅

**复杂度：** O(1)

**示例：**

```cpp
Vector3 v(1.0f, 1.0f, 0.0f);
Vector3 normal(1.0f, 0.0f, 0.0f);
Vector3 projected = Vector3::Project(v, normal);  // (1, 0, 0)
```

## 相关文档

- [Vector3 类总览](vector3.md) - 返回类总览
- [`ProjectOnPlane`](project-on-plane.md) - 投影到平面上