---
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/analysis/performance-memory/native-memory/allocator-reference
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/analysis/performance-memory/native-memory/allocator-reference.md
generated_at: 2026-11-19T15:27:43.500Z
locale: ko-kr
---

# 네이티브 메모리 할당자 레퍼런스

> 네이티브 메모리 할당자 설정에 대한 레퍼런스

커맨드 라인 인자를 사용하거나 Unity 에디터의 설정(**Edit > Project Settings > Memory Settings**)을 사용하여 네이티브 메모리 할당 방식을 제어할 수 있습니다. 네이티브 메모리 할당자를 커스터마이즈하는 방법에 대한 자세한 내용은 [네이티브 메모리 할당자 커스터마이즈](/engine/6000.0/manual/analysis/performance-memory/native-memory/memory-allocator-customization.md)를 참조하십시오.


**Project Settings > Memory Settings, showing a selection of Player memory settings:**
![](/api/media?file=/engine/6000.0/media/images/memory-native-settings.png)

다음 표에는 각 할당자 설정과 각각의 [커맨드 라인 인자](/engine/6000.0/manual/unity-editor/command-line-arguments.md) 및 기본값에 대한 정보가 포함되어 있습니다.

## 메인 할당자##main-allocators

이러한 할당자는 Unity 대부분의 할당에 사용합니다.

### 메인 할당자##main-allocator

Unity 대부분의 할당에 사용하는 기본 할당자입니다. 다음과 같은 설정이 있습니다.

| **설정**           | **설명**                   | **커맨드 라인 인자**                             | **기본값** |
| ---------------- | ------------------------ | ----------------------------------------- | ------- |
| **메인 스레드 블록 크기** | 전용 메인 스레드 할당자의 블록 크기입니다. | `memorysetup-main-allocator-block-size`   | 바이트     |
| **공유 스레드 블록 크기** | 공유 스레드 할당자의 블록 크기입니다.    | `memorysetup-thread-allocator-block-size` | 바이트     |

### Gfx 할당자##gfx-allocator

Unity Gfx 시스템과 관련된 CPU 할당에 사용하는 할당자입니다. 다음과 같은 설정이 있습니다.

| **설정**           | **설명**                       | **커맨드 라인 인자**                                 | **기본값** |
| ---------------- | ---------------------------- | --------------------------------------------- | ------- |
| **메인 스레드 블록 크기** | 전용 메인 스레드 Gfx 할당자의 블록 크기입니다. | `memorysetup-gfx-main-allocator-block-size`   | 바이트     |
| **공유 스레드 블록 크기** | 공유 스레드 Gfx 할당자의 블록 크기입니다.    | `memorysetup-gfx-thread-allocator-block-size` | 바이트     |

### 기타 할당자##other-allocators

타입 트리와 파일 캐시에 사용되는 할당입니다. 다음과 같은 설정이 있습니다.

| **설정**          | **설명**                                                    | **커맨드 라인 인자**                               | **기본값** |
| --------------- | --------------------------------------------------------- | ------------------------------------------- | ------- |
| **파일 캐시 블록 크기** | 파일 캐시에는 단편화를 방지하기 위해 고유한 할당자가 있습니다. 블록 크기입니다              | `memorysetup-cache-allocator-block-size`    | 바이트     |
| **타입 트리 블록 크기** | 타입 트리에는 소규모 할당으로 DUE 단편화를 방지하기 위해 고유한 할당자가 있습니다. 블록 크기입니다 | `memorysetup-typetree-allocator-block-size` | 바이트     |

### 공유 버킷 할당자##shared-bucket-allocator

메인 할당자 간에 공유되는 버킷 할당자입니다. 다음과 같은 설정이 있습니다.

| **설정**                 | **설명**                   | **커맨드 라인 인자**                               | **기본값**                               |
| ---------------------- | ------------------------ | ------------------------------------------- | ------------------------------------- |
| **버킷 할당자 세분화**         | 공유 할당자에 있는 버킷의 단계 크기입니다. | `memorysetup-bucket-allocator-granularity`  | 바이트                                   |
| **버킷 할당자 BucketCount** | 버킷 크기의 수입니다.             | `memorysetup-bucket-allocator-bucket-count` | `8`                                   |
| **버킷 할당기 블록 크기**       | 버킷에 사용되는 메모리 블록의 크기입니다.  | `memorysetup-bucket-allocator-block-size`   | 편집자: `8388608` 바이트플레이어: `4194304` 바이트 |
| **버킷 할당자 블록 수**        | 할당할 최대 블록 수입니다.          | `memorysetup-bucket-allocator-block-count`  | 편집자: `8`"Player",                     |

## Fast Per Thread 임시 할당자##fast-per-thread-temporary-allocators

매우 짧은 기간의 할당을 처리하는 [스레드 로컬 스토리지(TLS) 할당자](/engine/6000.0/manual/analysis/performance-memory/native-memory/allocators.md#tls)입니다.

| **할당자**            | **설명**                      | **커맨드 라인 인자**                                       | **기본값**(바이트 단위)          |
| ------------------ | --------------------------- | --------------------------------------------------- | ------------------------ |
| **메인 스레드 블록 크기**   | 메인 스레드 스택의 초기 크기입니다.        | `memorysetup-temp-allocator-size-main`              | 편집자: `16777216`"Player", |
| **잡 워커 블록 크기**     | Unity 잡 시스템의 각 잡 워커의 크기입니다. | `memorysetup-temp-allocator-size-job-worker`        | `E262144`                |
| **배경 작업 워커 블록 크기** | 각 백그라운드 워커의 크기입니다.          | `memorysetup-temp-allocator-size-background-worker` | `32768`                  |
| **사전 로드 블록 크기**    | 사전 로드 관리자 스택 크기입니다.         | `memorysetup-temp-allocator-size-preload-manager`   | 편집자: `33554432`"Player", |
| 오디오 워커 블록 크기       | 각 오디오 워커 스레드의 스택 크기입니다.     | `memorysetup-temp-allocator-size-audio-worker`      | `65536`                  |
| **클라우드 워커 블록 크기**  | 클라우드 워커 스레드 스택 크기입니다.       | `memorysetup-temp-allocator-size-cloud-worker`      | `32768`                  |
| **Gfx 스레드 블록 크기**  | 메인 렌더 스레드 스택 크기입니다.         | `memorysetup-temp-allocator-size-gfx`               | `262144`                 |
| **GI 베이킹 블록 크기**   | 각 GI 워커 스레드의 스택 크기입니다.      | `memorysetup-temp-allocator-size-gi-baking-worker`  | `262144`                 |
| **내비메시 워커 블록 크기**  | 내비메시 워커 스레드 스택 크기입니다.       | `memorysetup-temp-allocator-size-nav-mesh-worker`   | `65536`                  |

## 빠른 스레드 공유 임시 할당자##fast-thread-shared-temporary-allocators

스레드 간에 공유되는 단기 할당을 위한 [빠른 리니어 할당자](/engine/6000.0/manual/analysis/performance-memory/native-memory/allocators.md)입니다.

| **할당자**                   | **설명**                                           | **커맨드 라인 인자**                                              | **기본값**(바이트 단위) |
| ------------------------- | ------------------------------------------------ | ---------------------------------------------------------- | --------------- |
| **잡 할당자 블록 크기**           | Unity 주로 잡 워커 스레드에 사용하는 라운드 로빈 리니어 스레드 할당자입니다.   | `memorysetup-job-temp-allocator-block-size`                | `2097152`       |
| **배경 잡 할당자 블록 크기**        | 백그라운드 워커를 위한 리니어 할당자로, 수명이 긴 할당을 허용합니다.          | `memorysetup-job-temp-allocator-block-size-background`     | `21048576`      |
| **저메모리 플랫폼의 잡 할당자 블록 크기** | 메모리가 2GB 미만인 플랫폼은 잡 워커와 백그라운드 잡 모두에 이 크기를 사용합니다. | `memorysetup-job-temp-allocator-reduction-small-platforms` | `262144`        |

## 프로파일러 할당자##profiler-allocators

Unity가 애플리케이션의 할당 패턴을 방해하지 않도록 [프로파일러](/engine/6000.0/manual/analysis/profiler.md)에만 사용하는 할당자입니다. 다음 설정이 있습니다.

| **설정**              | **설명**                                        | **커맨드 라인 인자**                                      | **기본값**    |
| ------------------- | --------------------------------------------- | -------------------------------------------------- | ---------- |
| **프로파일러 블록 크기**     | 프로파일러의 주요 부분에 대한 블록 크기입니다.                    | `memorysetup-profiler-allocator-block-size`        | `16777216` |
| **에디터 프로파일러 블록 크기** | 프로파일러의 에디터 부분에 대한 블록 크기입니다. 플레이어에는 존재하지 않습니다. | `memorysetup-profiler-editor-allocator-block-size` | 바이트        |

### 공유 프로파일러 버킷 할당자##shared-profiler-bucket-allocator

프로파일러 및 에디터 프로파일러 할당자를 위한 공유 버킷 할당자입니다. 메모리 부족한 플랫폼에는 존재하지 않습니다. 다음과 같은 설정이 있습니다.

| **설정**                 | **설명**                                                         | **커맨드 라인 인자**                                        | **기본값**                                |
| ---------------------- | -------------------------------------------------------------- | ---------------------------------------------------- | -------------------------------------- |
| **버킷 할당자 세분화**         | 공유 할당자에 있는 버킷의 단계 크기입니다.                                       | `memorysetup-profiler-bucket-allocator-granularity`  | 바이트                                    |
| **버킷 할당자 BucketCount** | 버킷 크기의 수입니다. 예를 들어 값이 4인 경우 크기는 16바이트, 32바이트, 48바이트, 64바이트입니다. | `memorysetup-profiler-bucket-allocator-bucket-count` | `8`                                    |
| **버킷 할당기 블록 크기**       | 버킷에 사용되는 메모리 블록의 크기입니다.                                        | `memorysetup-profiler-bucket-allocator-block-size`   | 편집자: `33554432` 바이트플레이어: `4194304` 바이트 |
| **버킷 할당자 블록 수**        | 할당할 최대 블록 수입니다.                                                | `memorysetup-profiler-bucket-allocator-block-count`  | 편집자: `8`"Player",                      |

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

* [네이티브 메모리 할당자](/engine/6000.0/manual/analysis/performance-memory/native-memory/allocators.md)
* [네이티브 메모리 할당자 사용자 정의](/engine/6000.0/manual/analysis/performance-memory/native-memory/memory-allocator-customization.md)
* [네이티브 메모리 할당자 예제](/engine/6000.0/manual/analysis/performance-memory/native-memory/allocator-examples.md)
