В каких задачах использовал расширение методов

Использование расширений методов (Extension Methods) в разработке на Unity/C#

Расширения методов – это мощный инструмент C#, который я активно применяю в Unity-разработке для повышения читаемости, повторного использования кода и создания Domain-Specific Language (DSL) внутри проекта. Они позволяют добавлять методы к существующим типам, не меняя их исходный код и не создавая производные классы, что особенно ценно для работы со встроенными типами Unity (Vector3, Transform, GameObject) и структурами данных.

Я разделяю основные сценарии их использования на несколько ключевых категорий.

1. Работа с типами Unity и стандартными структурами данных

Это, пожалуй, самый частый случай. Методы расширения идеально подходят для добавления удобного функционала к классам движка.

Для математических операций и Vector3:

public static class Vector3Extensions
{
    // Удобное создание случайного вектора в пределах сферы
    public static Vector3 RandomPointInSphere(this Vector3 center, float radius)
    {
        return center + UnityEngine.Random.onUnitSphere * radius;
    }

    // Проверка на приблизительное равенство с учетом погрешности (Epsilon)
    public static bool Approximately(this Vector3 a, Vector3 b)
    {
        return Mathf.Approximately(a.x, b.x) &&
               Mathf.Approximately(a.y, b.y) &&
               Mathf.Approximately(a.z, b.z);
    }

    // "Обнуление" одной из осей (часто нужно для 2D игр или перемещения по плоскости)
    public static Vector3 WithY(this Vector3 vector, float newY)
    {
        return new Vector3(vector.x, newY, vector.z);
    }
}

// Использование становится очень естественным:
Vector3 spawnPosition = playerPosition.RandomPointInSphere(5f);
if (currentTarget.Approximately(previousTarget)) { ... }
Vector3 groundedPosition = characterPosition.WithY(0f);

Для Transform и GameObject:

public static class TransformExtensions
{
    // Рекурсивный поиск ребенка по имени (включая вложенные уровни)
    public static Transform FindDeepChild(this Transform parent, string childName)
    {
        foreach (Transform child in parent)
        {
            if (child.name == childName) return child;
            var result = child.FindDeepChild(childName);
            if (result != null) return result;
        }
        return null;
    }

    // Сброс всех трансформаций к значениям по умолчанию за один вызов
    public static void ResetTransforms(this Transform transform)
    {
        transform.localPosition = Vector3.zero;
        transform.localRotation = Quaternion.identity;
        transform.localScale = Vector3.one;
    }

    // Установка слоя для объекта и всех его детей
    public static void SetLayerRecursively(this GameObject go, int layer)
    {
        go.layer = layer;
        foreach (Transform child in go.transform)
        {
            child.gameObject.SetLayerRecursively(layer);
        }
    }
}

2. Улучшение API для компонентов и систем проекта

Я создаю расширения для кастомных MonoBehaviour и систем, чтобы сделать их использование более интуитивным.

public static class HealthComponentExtensions
{
    // Проверка, жив ли объект, и безопасное применение урона
    public static bool TryApplyDamage(this Health health, float damage)
    {
        if (health.IsAlive)
        {
            health.TakeDamage(damage);
            return true;
        }
        return false;
    }
}

public static class PoolingSystemExtensions
{
    // Получение объекта из пула с немедленной инициализацией позицией и активностью
    public static GameObject Spawn(this ObjectPool pool, Vector3 position)
    {
        GameObject obj = pool.Get();
        obj.transform.position = position;
        obj.SetActive(true);
        return obj;
    }
}

3. Операции с коллекциями и IEnumerable

Очень удобно для фильтрации, поиска и преобразования данных, особенно связанных с игровыми объектами.

public static class CollectionExtensions
{
    // Получение случайного элемента из списка
    public static T GetRandom<T>(this IList<T> list)
    {
        if (list == null || list.Count == 0) return default;
        return list[UnityEngine.Random.Range(0, list.Count)];
    }

    // Поиск ближайшего объекта в коллекции к заданной точке
    public static Transform FindClosestToPoint(this IEnumerable<Transform> transforms, Vector3 point)
    {
        Transform closest = null;
        float closestDist = float.MaxValue;
        foreach (var t in transforms)
        {
            float dist = (t.position - point).sqrMagnitude;
            if (dist < closestDist)
            {
                closestDist = dist;
                closest = t;
            }
        }
        return closest;
    }

    // Удобный null-check для списков (часто используется перед циклом)
    public static bool IsNullOrEmpty<T>(this ICollection<T> collection)
    {
        return collection == null || collection.Count == 0;
    }
}

4. Вспомогательные утилиты для логирования и отладки

Расширения могут значительно упростить процесс отладки, делая вывод данных более структурированным.

public static class DebugExtensions
{
    // Логирование всей коллекции с поясняющим сообщением
    public static void LogCollection<T>(this IEnumerable<T> collection, string prefix = "")
    {
        Debug.Log($"{prefix} [{string.Join(", ", collection)}]");
    }

    // Визуализация направления в редакторе (например, для AI или путей)
    public static void DrawDebugRay(this Transform transform, float length, Color color, float duration = 0.5f)
    {
        Debug.DrawRay(transform.position, transform.forward * length, color, duration);
    }
}

Преимущества и выводы

Использование расширений методов в моей практике дает следующие ключевые преимущества:

• Читаемость кода: Цепочки вызовов становятся похожими на естественный язык (transform.ResetTransforms().SetLayerRecursively(8)).
• Инкапсуляция и повторное использование: Логика, которая иначе дублировалась бы в разных классах, централизуется в одном статическом классе.
• Неинвазивность: Нет необходимости модифицировать исходный код классов Unity или сторонних библиотек.
• Улучшение workflow: Создается удобный, проектно-специфичный API, который ускоряет разработку и снижает количество ошибок.
• Безопасность: Можно добавить проверки и обработку граничных случаев в одном месте (например, проверку на null в GetRandom).

Главное правило, которого я придерживаюсь – расширения должны быть интуитивно понятными и вести себя предсказуемо, не "ломая" семантику оригинального типа. Их чрезмерное использование для простых задач может ухудшить читаемость, поэтому я применяю их там, где они действительно добавляют ценности и сокращают boilerplate-код.