XCEngine/docs/api/memory/manager/manager.md

# MemoryManager

**命名空间**: `XCEngine::Memory`

**类型**: `class` (singleton)

**头文件**: `XCEngine/Memory/MemoryManager.h`

**描述**: 全局内存管理器单例，提供系统分配器和各种专用分配器的创建。

## 概述

`MemoryManager` 是 XCEngine 内存管理系统的核心单例。它负责维护系统分配器，提供分配器工厂方法，并支持内存泄漏检测和报告。

## 单例访问

| 方法 | 描述 |
|------|------|
| [`Get`](get.md) | 获取单例实例 |

## 公共方法

| 方法 | 描述 |
|------|------|
| [`Initialize`](initialize.md) | 初始化内存管理器 |
| [`Shutdown`](shutdown.md) | 关闭内存管理器 |
| [`GetSystemAllocator`](get-system-allocator.md) | 获取系统默认分配器 |
| [`CreateLinearAllocator`](create-linear-allocator.md) | 创建线性分配器 |
| [`CreatePoolAllocator`](create-pool-allocator.md) | 创建内存池分配器 |
| [`CreateProxyAllocator`](create-proxy-allocator.md) | 创建代理分配器 |
| [`SetTrackAllocations`](set-track-allocations.md) | 设置是否跟踪分配 |
| [`DumpMemoryLeaks`](dump-memory-leaks.md) | 输出内存泄漏报告 |
| [`GenerateMemoryReport`](generate-memory-report.md) | 生成内存使用报告 |

## 宏定义

### XE_ALLOC

```cpp
#define XE_ALLOC(allocator, size, ...) allocator->Allocate(size, ##__VA_ARGS__)
```

内存分配宏。

### XE_FREE

```cpp
#define XE_FREE(allocator, ptr) allocator->Free(ptr)
```

内存释放宏。

## 使用示例

```cpp
#include <XCEngine/Memory/MemoryManager.h>

// 初始化
MemoryManager::Get().Initialize();

// 获取系统分配器
IAllocator* sysAlloc = MemoryManager::Get().GetSystemAllocator();

// 创建专用分配器
auto linearAlloc = MemoryManager::Get().CreateLinearAllocator(1024 * 1024);
auto poolAlloc = MemoryManager::Get().CreatePoolAllocator(sizeof(MyObject), 1000);
auto proxyAlloc = MemoryManager::Get().CreateProxyAllocator("GameFrame");

// 使用宏分配
void* ptr = XE_ALLOC(proxyAlloc, 256);
XE_FREE(proxyAlloc, ptr);

// 跟踪内存
MemoryManager::Get().SetTrackAllocations(true);
MemoryManager::Get().GenerateMemoryReport();

// 关闭
MemoryManager::Get().Shutdown();
```

## 相关文档

- [Memory 模块总览](../memory.md) - 返回模块总览
- [IAllocator](../allocator/allocator.md) - 分配器接口
- [LinearAllocator](../linear-allocator/linear-allocator.md) - 线性分配器
- [PoolAllocator](../pool-allocator/pool-allocator.md) - 内存池分配器
- [ProxyAllocator](../proxy-allocator/proxy-allocator.md) - 代理分配器