如何在Unity中扩展Vector2Int结构体实现位置环绕功能？

不用重写Unity的Vector2Int，可以通过自定义一个包装结构体来实现自动环绕逻辑，同时完全复用Vector2Int的原有功能。核心思路是内部持有Vector2Int实例，通过属性的setter处理环绕，并重载必要的运算符，让所有算术操作自动触发环绕处理。

实现代码 #

public struct WrappedVector2Int
{
    // 全局地图尺寸，游戏启动时初始化（比如在GameManager的Awake里设置）
    public static int MapWidth;
    public static int MapHeight;

    private Vector2Int _innerVector;

    public int X
    {
        get => _innerVector.x;
        set => _innerVector.x = WrapCoordinate(value, MapWidth);
    }

    public int Y
    {
        get => _innerVector.y;
        set => _innerVector.y = WrapCoordinate(value, MapHeight);
    }

    public WrappedVector2Int(int x, int y)
    {
        _innerVector = new Vector2Int();
        // 初始化时自动处理环绕
        X = x;
        Y = y;
    }

    // 处理坐标环绕，兼容负数情况（比如-1转为MapWidth-1）
    private static int WrapCoordinate(int value, int maxSize)
    {
        if (maxSize <= 0) return value;
        
        value %= maxSize;
        // 修正C#取模负数的问题
        return value < 0 ? value + maxSize : value;
    }

    // 重载加法运算符，自动处理环绕
    public static WrappedVector2Int operator +(WrappedVector2Int a, WrappedVector2Int b)
    {
        return new WrappedVector2Int(a.X + b.X, a.Y + b.Y);
    }

    // 支持和原生Vector2Int的加法
    public static WrappedVector2Int operator +(WrappedVector2Int a, Vector2Int b)
    {
        return new WrappedVector2Int(a.X + b.x, a.Y + b.y);
    }

    // 重载乘法运算符（示例，可根据需求扩展其他运算符）
    public static WrappedVector2Int operator *(WrappedVector2Int a, int scalar)
    {
        return new WrappedVector2Int(a.X * scalar, a.Y * scalar);
    }

    // 隐式转换为原生Vector2Int，兼容Unity原有API（比如传递给Grid组件）
    public static implicit operator Vector2Int(WrappedVector2Int wrapped)
    {
        return wrapped._innerVector;
    }

    // 显式从原生Vector2Int转换为WrappedVector2Int
    public static explicit operator WrappedVector2Int(Vector2Int vec)
    {
        return new WrappedVector2Int(vec.x, vec.y);
    }
}

使用方式 #

1. 游戏启动时初始化地图尺寸：

// 在GameManager或类似的初始化脚本中
WrappedVector2Int.MapWidth = 100;
WrappedVector2Int.MapHeight = 100;

2. 日常使用和原生Vector2Int几乎一致，所有操作自动触发环绕：

var pos = new WrappedVector2Int(99, 99);
var displacement = new WrappedVector2Int(1, 1);
var newPos = pos + displacement;
// newPos.X和newPos.Y都会是0，符合需求

// 也可以和原生Vector2Int交互
Vector2Int unityVec = new Vector2Int(5, 5);
WrappedVector2Int wrappedVec = (WrappedVector2Int)unityVec;

方案优势 #

• 完全复用Vector2Int的内部逻辑，无需复制其源码
• 所有算术操作（+、*等）自动处理环绕，无需手动调用辅助函数
• 支持和原生Vector2Int互相转换，兼容Unity的Grid、Tilemap等API
• 处理了负数坐标的边界情况（比如new WrappedVector2Int(-1, 0)会自动转为(99, 0)）

内容的提问来源于stack exchange，提问作者Jinglesting