diff --git a/GFramework.Core/Extensions/ArrayExtensions.cs b/GFramework.Core/Extensions/ArrayExtensions.cs
index bc711f9..9f26b3a 100644
--- a/GFramework.Core/Extensions/ArrayExtensions.cs
+++ b/GFramework.Core/Extensions/ArrayExtensions.cs
@@ -32,4 +32,137 @@ public static class ArrayExtensions
x < array.GetLength(0) &&
y < array.GetLength(1);
}
+
+
+ ///
+ /// 获取二维数组指定位置的元素,如果越界则返回默认值。
+ ///
+ /// 数组元素类型。
+ /// 要访问的二维数组。
+ /// X 坐标(第一维索引)。
+ /// Y 坐标(第二维索引)。
+ /// 如果在边界内返回该位置的元素;否则返回类型的默认值。
+ public static T? GetOrDefault(this T[,] array, int x, int y)
+ {
+ return array.IsInBounds(x, y) ? array[x, y] : default;
+ }
+
+ ///
+ /// 获取二维数组指定位置的元素,如果越界则返回指定的回退值。
+ ///
+ /// 数组元素类型。
+ /// 要访问的二维数组。
+ /// X 坐标(第一维索引)。
+ /// Y 坐标(第二维索引)。
+ /// 当坐标越界时返回的回退值。
+ /// 如果在边界内返回该位置的元素;否则返回指定的回退值。
+ public static T GetOr(this T[,] array, int x, int y, T fallback)
+ {
+ return array.IsInBounds(x, y) ? array[x, y] : fallback;
+ }
+
+ ///
+ /// 尝试获取二维数组指定位置的元素。
+ ///
+ /// 数组元素类型。
+ /// 要访问的二维数组。
+ /// X 坐标(第一维索引)。
+ /// Y 坐标(第二维索引)。
+ /// 输出参数,用于存储获取到的元素值。
+ /// 如果成功获取元素则返回 true;否则返回 false。
+ public static bool TryGet(this T[,] array, int x, int y, out T value)
+ {
+ if (array.IsInBounds(x, y))
+ {
+ value = array[x, y];
+ return true;
+ }
+
+ value = default!;
+ return false;
+ }
+
+ ///
+ /// 获取二维数组中某个位置的四个方向邻居坐标(上、下、左、右)。
+ ///
+ /// 数组元素类型。
+ /// 源二维数组。
+ /// 中心位置的 X 坐标。
+ /// 中心位置的 Y 坐标。
+ /// 按顺序返回所有在边界内的邻居坐标。
+ public static IEnumerable<(int x, int y)> GetNeighbors4(this T[,] array, int x, int y)
+ {
+ var dirs = new (int dx, int dy)[]
+ {
+ (0, -1), (0, 1),
+ (-1, 0), (1, 0)
+ };
+
+ foreach (var (dx, dy) in dirs)
+ {
+ var nx = x + dx;
+ var ny = y + dy;
+
+ if (array.IsInBounds(nx, ny))
+ yield return (nx, ny);
+ }
+ }
+
+ ///
+ /// 获取二维数组中某个位置的八个方向邻居坐标(包括对角线)。
+ ///
+ /// 数组元素类型。
+ /// 源二维数组。
+ /// 中心位置的 X 坐标。
+ /// 中心位置的 Y 坐标。
+ /// 按顺序返回所有在边界内的邻居坐标(不包括中心位置)。
+ public static IEnumerable<(int x, int y)> GetNeighbors8(this T[,] array, int x, int y)
+ {
+ for (var dx = -1; dx <= 1; dx++)
+ {
+ for (var dy = -1; dy <= 1; dy++)
+ {
+ if (dx == 0 && dy == 0) continue;
+
+ var nx = x + dx;
+ var ny = y + dy;
+
+ if (array.IsInBounds(nx, ny))
+ yield return (nx, ny);
+ }
+ }
+ }
+
+ ///
+ /// 枚举二维数组中的所有元素及其坐标。
+ ///
+ /// 数组元素类型。
+ /// 要枚举的二维数组。
+ /// 依次返回每个元素的坐标和值的元组。
+ public static IEnumerable<(int x, int y, T value)> Enumerate(this T[,] array)
+ {
+ for (var x = 0; x < array.GetLength(0); x++)
+ {
+ for (var y = 0; y < array.GetLength(1); y++)
+ {
+ yield return (x, y, array[x, y]);
+ }
+ }
+ }
+
+ ///
+ /// 获取二维数组的宽度(第一维长度)。
+ ///
+ /// 数组元素类型。
+ /// 要获取宽度的二维数组。
+ /// 数组的第一维长度。
+ public static int Width(this T[,] array) => array.GetLength(0);
+
+ ///
+ /// 获取二维数组的高度(第二维长度)。
+ ///
+ /// 数组元素类型。
+ /// 要获取高度的二维数组。
+ /// 数组的第二维长度。
+ public static int Height(this T[,] array) => array.GetLength(1);
}
\ No newline at end of file