# Vector3::ProjectOnPlane

```cpp
static Vector3 ProjectOnPlane(const Vector3& vector, const Vector3& planeNormal)
```

将向量投影到平面上（减去沿平面法线的分量）。

**参数：**
- `vector` - 要投影的向量
- `planeNormal` - 平面法线

**返回：** `Vector3` - 平面上的投影向量

**线程安全：** ✅

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

**示例：**

```cpp
Vector3 v(1.0f, 1.0f, 1.0f);
Vector3 normal(0.0f, 1.0f, 0.0f);  // XZ 平面
Vector3 projected = Vector3::ProjectOnPlane(v, normal);  // (1, 0, 1)
```

## 相关文档

- [Vector3 类总览](vector3.md) - 返回类总览
- [`Project`](project.md) - 投影到法线上