# Vector3::SqrMagnitude

```cpp
float SqrMagnitude() const
```

计算向量长度的平方。用于在不计算平方根的情况下比较长度，性能更优。

**返回：** `float` - 向量长度的平方

**线程安全：** ✅

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

**示例：**

```cpp
Vector3 v(3.0f, 4.0f, 0.0f);
float sqrMag = v.SqrMagnitude();  // 25.0f
```

## 相关文档

- [Vector3 总览](vector3.md)
- [`Magnitude`](magnitude-instance.md) - 向量长度
- [`Normalized`](normalized.md) - 归一化副本
- [`static SqrMagnitude`](sqrmagnitude.md) - 静态版本