---
title: 오브젝트 풀링 및 재사용
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/scripting/optimization/performance-optimizing-code-managed-memory/reusable-code
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/scripting/optimization/performance-optimizing-code-managed-memory/reusable-code.md
generated_at: 2026-11-19T13:46:00.494Z
locale: ko-kr
---

# 오브젝트 풀링 및 재사용

> Unity UnityEngine.Pool API를 사용하여 자주 사용되는 오브젝트를 반복적으로 생성하거나 제거하지 않고 풀링하고 재사용할 수 있도록 CPU 로드와 가비지 컬렉터 오버헤드를 줄일 수 있습니다.

오브젝트 풀링 및 재사용은 자주 사용되는 오브젝트의 인스턴스를 풀로 반환하여 검색해서 다시 사용할 수 있는 프로그래밍 패턴입니다. 오브젝트 풀링은 새로운 오브젝트 인스턴스를 반복적으로 인스턴스화하고 제거하여 발생하는 오버헤드를 줄이고, 할당 및 할당 해제의 전체 수를 제한합니다. 이렇게 하면 가비지 컬렉션(GC) 오버헤드가 최소화되고 CPU 부하가 줄어듭니다.

GameObjects 오브젝트를 풀링할 수 있지만, 배열, 리스트, 딕셔너리 등과 같은 자주 사용하는 다른 타입도 풀링할 수 있습니다. 자체 풀링 로직을 작성할 수 있지만 편의를 위해 Unity는 풀링 GameObjects 및 여러 컬렉션 타입을 구현할 수 있는 API 세트를 `UnityEngine.Pool` 네임스페이스에 제공합니다.

> **Note:**
>
> 다른 많은 주요 Unity API와 마찬가지로, `UnityEngine.Pool` API는 스레드 세이프가 아니며 메인 스레드에서만 안전하게 호출할 수 있습니다.

## 풀링 및 GameObjects 재사용##pooling-and-reusing-gameobjects

게임에서 발사체와 같은 일부 타입의 오브젝트는 동시에 씬에만 있는 경우에도 반복적으로 자주 나타날 수 있습니다. 게임을 시작할 때 새 발사체 오브젝트가 발사될 때마다 새 발사체 오브젝트를 프리맵에서 인스턴스화하는 대신, 이를 필요에 따라 재사용할 수 있습니다.

### 오브젝트 풀 생성##creating-an-object-pool

Unity의 [`ObjectPool<T>`](/engine/6000.0/script-reference/unityengine/pool/objectpool1.md) 클래스는 재사용 가능한 오브젝트 풀 패턴을 구현하며, 애플리케이션에서 오브젝트 풀을 구현하는 가장 간단한 방법입니다. `ObjectPool<T>`의 인스턴스는 `T` 타입의 오브젝트 풀을 관리합니다. [`ObjectPool<T>` 생성자](/engine/6000.0/script-reference/unityengine/pool/objectpool1/ctor.md)를 통해 `ObjectPool<T>`를 생성할 때 풀의 다음 주요 요소를 정의하는 파라미터를 제공합니다.

* 풀의 시작 용량입니다.

* 풀이 늘릴 수 있는 최대 용량입니다.

* 동일한 오브젝트 인스턴스가 풀로 다시 릴리스되지 않도록 수집 안전 검사를 수행하는지 여부.

* 풀에서 다음과 같은 주요 작업을 수행할 때 Unity가 호출하는 일련의 C# [`Action<T>`](https://learn.microsoft.com/en-us/dotnet/api/system.action-1?view=net-10.0) 델리게이트입니다.

  * 풀에서 오브젝트를 검색해서 가져올 때 호출하는 콜백입니다.
  * 풀에 오브젝트를 반환할 때 호출하는 콜백입니다.
  * 요청된 경우 풀이 비어있을 때 새 오브젝트 인스턴스를 생성할 때 호출하는 콜백입니다.
  * 풀에 반환되었지만 풀 용량이 최대이면 오브젝트 인스턴스를 파괴할 때 호출하는 콜백입니다.

### 풀에서 오브젝트 검색##retrieving-objects-from-the-pool

풀에서 오브젝트를 가져오기 위해 [`ObjectPool<T>.Get`](ScriptRef:ScriptRef:Pool.ObjectPool_1.Get)를 호출합니다. 또한 이 작업은 `ObjectPool` 생성자에 `actionOnGet` 파라미터로 제공한 메서드를 호출하므로 사용을 위해 오브젝트를 준비하고 활성화할 수 있습니다.

풀이 비어있을 때 풀에서 오브젝트를 요청하면 새 오브젝트 인스턴스가 생성됩니다. 생성 프로세스는 `ObjectPool` 생성자에 `createFunc` 파라미터로 제공한 메서드를 호출합니다.

`ObjectPool<T>.Get`은 과부하 `Get(out PooledObject<T> pooledObject)`입니다. `PooledObject`가 폐기되면 인스턴스를 자동으로 해제합니다. 수명이 짧은 범위에 유용합니다.

자세한 내용과 코드 예제는 [`PooledObject<T>.Get` API 레퍼런스](ScriptRef:Pool.PooledObject_1.Get)를 참조하십시오.

### 오브젝트를 풀로 반환##returning-objects-to-the-pool

오브젝트를 완료하면 반환하는 오브젝트를 인수로 사용하여 [`ObjectPool<T>.Release`](/engine/6000.0/script-reference/unityengine/pool/objectpool1/release.md)를 호출하여 풀로 반환합니다. 또한 이 작업은 `ObjectPool` 생성자에 `actionOnRelease` 파라미터로 제공한 메서드를 호출하여 반환된 객체의 상태를 비활성화하고 재설정할 기회를 제공합니다.

풀이 가득 차면 오브젝트를 풀로 반환하면 오브젝트가 파괴됩니다. 파괴 프로세스는 `ObjectPool` 생성자에 `actionOnDestroy` 파라미터로 제공한 메서드를 호출합니다.

생성자에 `true`를 `collectionCheck` 파라미터로 전달하면 수집 안전 검사가 가능합니다. 컬렉션 확인이 활성화되고 이미 풀에 있는 오브젝트를 반환하려고 하면 Unity 예외를 발생시킵니다. 이 옵션을 활성화한 경우에도 컬렉션 확인은 플레이어 빌드가 아니라 에디터에서만 사용할 수 있습니다. 컬렉션 검사를 활성화하면 오버헤드가 추가되지만, 이중 릴리스 오류는 감지되며, 개발 중에 권장됩니다.

### 사용되는 오브젝트 재설정##resetting-used-objects

풀에서 가져온 오브젝트는 사용 중에 상태를 변경할 수 있습니다. 예를 들어 풀링된 적 게임 오브젝트는 씬에서 활성 상태일 때 포지션, 체력, 애니메이션 상태, 물리 상태를 변경할 수 있습니다. 오브젝트가 풀로 반환될 때 이 상태를 재설정해야 나중에 다시 가져오면 처음 사용 시와 동일한 상태로 시작됩니다.

초기화하는 상태에 따라 오브젝트를 `actionOnGet` 델리게이트의 풀에서 가져오거나, `actionOnRelease` 델리게이트의 풀로 다시 놓으면 오브젝트를 초기화할 수 있습니다. 또 다른 방법은 풀된 오브젝트 자체에 커스텀 비활성화 메서드를 구현하고 풀의 Get 또는 Release 액션에서 해당 메서드를 호출하는 것입니다.

초기화해야 하는 상태는 풀된 오브젝트의 특정 동작과 컴포넌트에 따라 다릅니다. 릴리스 시 일반적인 재설정 작업에는 코루틴 중지, 이벤트 구독 취소, 물리 상태 재설정, 애니메이션 지우기, 파티클 시스템 중지 등이 있습니다. 풀에서 비활성 상태일 때 GameObjects가 [`Update`](/engine/6000.0/script-reference/unityengine/monobehaviour/update.md) 호출을 수신하지 않도록 해주는 것도 중요합니다.

### 예: 발사체 풀링##example:-pooling-projectiles

발사체에 대한 일반적인 `ObjectPool<T>` 구현에는 다음과 같은 주요 단계가 있습니다.

1. 게임을 시작할 때 비활성 발사체 오브젝트의 풀을 생성합니다. 풀된 오브젝트를 새로 생성하고, 풀에서 오브젝트를 검색해서 가져오고, 오브젝트를 풀로 다시 놓고, 풀이 가득하므로 오브젝트를 파괴할 때 콜백으로 호출할 수 있는 필수 델리게이트를 생성자에 제공합니다.
2. 발사체가 필요할 때(예: 사용자가 무기를 발사할 때) `ObjectPool<T>.Get`가 있는 풀에서 비활성 발사체를 가져옵니다. 해당 `actionOnGet` 콜백에서 가져온 객체를 활성화하고 해당 위치와 방향과 같은 관련 프로퍼티를 초기화합니다.
3. 발사체가 더 이상 필요하지 않을 때(예: 타겟에 부딪히거나 경계를 벗어날 때), `ObjectPool<T>.Release`로 풀로 반환합니다. 일반적으로 발사체가 완료되면 풀에 대한 레퍼런스를 부여하여 릴리스할 수 있습니다. 해당 `actionOnRelease` 콜백에서 반환된 오브젝트를 비활성화하고 속도 및 애니메이션 상태와 같은 관련 프로퍼티를 재설정합니다.

다음은 `ObjectPool<T>`에 풀링된 발사체의 스크립트 컴포넌트 코드입니다. 발사체에는 공용 프로퍼티가 있어 자체 풀에 대한 레퍼런스를 부여하며, 이 프로퍼티를 사용하여 시간 지연 후 풀에 다시 방출됩니다.

```cs
using System.Collections;
    using System.Collections.Generic;
    using UnityEngine;
    using UnityEngine.Pool;
    public class RevisedProjectile : MonoBehaviour
    {
        // Deactivate after delay
        [SerializeField] private float timeoutDelay = 3f;

        private IObjectPool<RevisedProjectile> objectPool;

        // Public property to give the projectile a reference to its ObjectPool
        public IObjectPool<RevisedProjectile> ObjectPool { set => objectPool = value; }

        public void Deactivate()
        {
            StartCoroutine(DeactivateRoutine(timeoutDelay));
        }

        IEnumerator DeactivateRoutine(float delay)
        {
            yield는 새 WaitForSeconds(지연)를 반환합니다.

            // Reset the moving Rigidbody
            Rigidbody rBody = GetComponent<Rigidbody>();
            rBody.linearVelocity = new Vector3(0f, 0f, 0f);
            rBody.angularVelocity = new Vector3(0f, 0f, 0f);

            // Release the projectile back to the pool
            objectPool.Release(this);
        }
    }
```

다음은 발사체를 발사하고 발사체 오브젝트 풀을 관리하는 총 포탑에 연결된 컴포넌트의 코드입니다. 총은 사용자가 발사할 때 오브젝트 풀의 `Get`를 호출하여 풀된 발사체를 검색합니다.

```cs
using UnityEngine;
    using UnityEngine.Pool;
    using UnityEngine.Events;

    public class RevisedGun : MonoBehaviour
    {
        [툴팁("발사 프리맵")]
        [SerializeField] private RevisedProjectile projectilePrefab;
        [Tooltip("Projectile force")]
        [SerializeField] private float muzzleVelocity = 1500f;
        [툴팁("총이 나타나는 끝 지점")]
        [SerializeField] private Transform muzzlePosition;
        [툴팁("발사 사이의 시간 / 작을수록 발사율이 높음")]
        [SerializeField] private float cooldownWindow = 0.1f;

        [SerializeField] private UnityEvent m_GunFired;

        // Stack-based ObjectPool available with Unity 2021 and above
        private IObjectPool<RevisedProjectile> objectPool;

        // Throw an exception if we try to return an existing item, already in the pool
        [SerializeField] private bool collectionCheck = true;

        // Extra options to control the pool capacity and maximum size
        [SerializeField] private int defaultCapacity = 20;
        [SerializeField] private int maxSize = 100;

        private float nextTimeToShoot;

        private void Awake()
        {
            objectPool = new ObjectPool<RevisedProjectile>(CreateProjectile,
                OnGetFromPool, OnReleaseToPool, OnDestroyPooledObject,
                collectionCheck, defaultCapacity, maxSize);
        }

        // Invoked when creating an item to populate the object pool
        private RevisedProjectile CreateProjectile()
        {
            RevisedProjectile projectileInstance = Instantiate(projectilePrefab);
            projectileInstance.ObjectPool = objectPool;
            return projectileInstance;
        }

        // Invoked when returning an item to the object pool
        private void OnReleaseToPool(RevisedProjectile pooledObject)
        {
            pooledObject.gameObject.SetActive(false);
        }

        // Invoked when retrieving the next item from the object pool
        private void OnGetFromPool(RevisedProjectile pooledObject)
        {
            pooledObject.gameObject.SetActive(true);
        }

        // Invoked when the maximum number of pooled items is exceeded (i.e. destroy the pooled object)
        private void OnDestroyPooledObject(RevisedProjectile pooledObject)
        {
            Destroy(pooledObject.gameObject);
        }

        private void FixedUpdate()
        {
            // Invokes the Shoot method if the delay time is exceeded
            if (Input.GetButton("Fire1") && Time.time > nextTimeToShoot && objectPool != null)
            {
                Shoot();
            }
        }

        private void Shoot()
        {
            // Get a pooled object instead of instantiating
            RevisedProjectile bulletObject = objectPool.Get();

            if (bulletObject == null)
                반환;

            // Align to gun barrel/muzzle position
            bulletObject.transform.SetPositionAndRotation(muzzlePosition.position, muzzlePosition.rotation);

            // Move projectile forward
            bulletObject.GetComponent<Rigidbody>().AddForce(bulletObject.transform.forward * muzzleVelocity, ForceMode.Acceleration);

            // Turn off after a few seconds
            bulletObject.Deactivate();

            // Set cooldown delay
            nextTimeToShoot = Time.time + cooldownWindow;

            m_GunFired.Invoke();
        }
    }
```

[에셋 스토어](https://assetstore.unity.com/packages/essentials/tutorial-projects/level-up-your-code-with-design-patterns-and-solid-289616))에서 무료 패키지로 다운로드할 수 있습니다. 이 코드를 사용하는 완벽한 작업 예제 프로젝트에는 필요한 모든 프리랩과 풀링된 발사체를 발사하는 작업 포탑이 포함되어 있습니다. 자세한 내용은 [Unity](https://learn.unity.com/course/design-patterns-unity-6/tutorial/use-object-pooling-to-boost-performance-of-c-scripts-in-unity#67a0d722edbc2a14cfcb7400)에서 C# 스크립트의 성능을 향상시키는 오브젝트 풀링 사용을 참고하십시오.

### 풀링된 오브젝트에 대한 씬 언로드 처리##handling-scene-unload-for-pooled-objects

기본적으로 오브젝트 풀은 오브젝트가 생성된 씬과 연계됩니다. 해당 씬이 언로드되면 Unity 풀과 풀된 인스턴스를 포함하여 해당 씬의 모든 GameObjects 오브젝트를 파기합니다.

풀 관리자를 호출하는 루트 게임 오브젝트 아래에 배치하여 씬이 다시 로드된 후 오브젝트 풀이 유지되도록 만들 수 있습니다. [`object.DontDestroyOnLoad`](/engine/6000.0/script-reference/unityengine/object/dontdestroyonload.md). [`transform.SetParent`](/engine/6000.0/script-reference/unityengine/transform/setparent.md)을 호출하여 풀 루트 아래에 풀된 항목을 다시 재배치하여 씬으로 파괴되지 않도록 해제할 수 있습니다.

언로드 시 씬에 활성 풀링된 인스턴스가 있을 수 있는 경우 해당 인스턴스가 [`OnDisable`](/engine/6000.0/script-reference/unityengine/monobehaviour/ondisable.md) 및 [`OnDestroy`](/engine/6000.0/script-reference/unityengine/monobehaviour/ondestroy.md)에서 직접 해제되도록 하거나 항목을 리콜하거나 파괴하기 위해 [`SceneManager.activeSceneChanged`](/engine/6000.0/script-reference/unityengine/scenemanagement/scenemanager/activescenechanged.md) 콜백을 등록해야 합니다.

비활성화하면 풀링된 인스턴스에 대한 레퍼런스 시간이 오래 걸리지 않습니다. [`ObjectPool<T>.Clear`](/engine/6000.0/script-reference/unityengine/pool/objectpool1/clear.md)를 사용하여 레벨 사이의 비활성 인스턴스를 모두 파괴합니다.

## 컬렉션 타입 풀링 및 재사용##pooling-and-reusing-collection-types

Lists 및 Dictionary와 같이 [`System.Collection`](https://docs.microsoft.com/en-us/dotnet/api/system.collections.generic?view=net-6.0) 네임스페이스의 컬렉션 오브젝트를 풀링하고 재사용할 수도 있습니다.

컬렉션 클래스는 컬렉션의 값을 제거하지만 컬렉션에 할당된 메모리를 해제하지 않는 `Clear` 메서드를 노출합니다. 복잡한 계산을 위한 임시 헬퍼 Collections 할당하려는 경우에 유용합니다.

다음 예제 코드는 프레임당 한 번의 `nearestNeighbors` `List`를 할당하여 데이터 포인트 집합을 수집합니다. 이는 비효율적인 부적절한 방법입니다.

```lang-cs
// Bad C# script example. This Update method allocates a new `List` every frame.
void Update() {

    List<float> nearestNeighbors = new List<float>();

    findDistancesToNearestNeighbors(nearestNeighbors);

    nearestNeighbors.Sort();

    // … use the sorted list somehow …
}
```

대신 이 `List`를 메서드에서 포함 클래스에 추가하고 매번 지우고 재사용하면 코드가 프레임마다 새 `List`를 할당할 필요가 없습니다.

```lang-cs
// Good C# script example. This method re-uses the same List every frame.
List<float> m_NearestNeighbors = new List<float>();

void Update() {

    m_NearestNeighbors.Clear();

    findDistancesToNearestNeighbors(NearestNeighbors);

    m_NearestNeighbors.Sort();

    // … use the sorted list somehow …
}
```

이 예제 코드는 여러 프레임에서 `List` 인스턴스 메모리를 유지하고 재사용합니다. 코드는 `List`를 확장해야 할 때만 새 메모리를 할당합니다.

`UnityEngine.Pool` 네임스페이스는 `List<T>`, `HashSet<T>`, `Dictionary<TKey, TValue>` 등 여러 컬렉션 유형에 대한 준비된 풀 구현도 제공합니다. `ObjectPool<T>`와 동일한 원칙으로 작동하므로 필요에 따라 풀링된 컬렉션 오브젝트 인스턴스를 가져오고 릴리스할 수 있습니다. 자세한 내용과 예제는 동일한 네임스페이스의 [`CollectionPool<T>`](ScriptRef:Pool.CollectionPool_1) 및 기타 컬렉션 타입별 풀 클래스에 대한 API 레퍼런스 문서를 참조하십시오.

## 추가 리소스##additional-resources

* [학습 튜토리얼: 오브젝트 풀링을 사용하여 Unity](https://learn.unity.com/course/design-patterns-unity-6/tutorial/use-object-pooling-to-boost-performance-of-c-scripts-in-unity#67a0d722edbc2a14cfcb7400)에서 C# 스크립트의 성능을 향상
* [관리형 메모리 소개](/engine/6000.0/manual/analysis/performance-memory/managed-memory/introduction.md)
* [레퍼런스 유형 관리](/engine/6000.0/manual/scripting/optimization/performance-optimizing-code-managed-memory/reference-types.md)
* [배열 최적화](/engine/6000.0/manual/scripting/optimization/performance-optimizing-code-managed-memory/arrays.md)
* [발사체와 폭발을 인스턴스화한다](/engine/6000.0/manual/working-with-gameobjects/prefabs/instantiating/projectiles.md)
