XCEngine/docs/api/threading/threading.md

# Threading 模块概览

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

**类型**: `module`

**头文件**: `XCEngine/Threading/Threading.h`

**描述**: XCEngine 的线程和并发模块，提供多线程编程所需的同步原语和任务系统。

## 概述

Threading 模块提供了一套完整的多线程编程工具，包括线程封装、同步原语和并行任务系统。

## 模块内容

### 同步原语

| 组件 | 文件 | 描述 |
|------|------|------|
| [Mutex](mutex/mutex.md) | `Mutex.h` | 互斥锁 |
| [SpinLock](spinlock/spinlock.md) | `SpinLock.h` | 自旋锁 |
| [ReadWriteLock](readwritelock/readwritelock.md) | `ReadWriteLock.h` | 读写锁 |

### 线程

| 组件 | 文件 | 描述 |
|------|------|------|
| [Thread](thread/thread.md) | `Thread.h` | 线程封装类 |

### 任务系统

| 组件 | 文件 | 描述 |
|------|------|------|
| [ITask](task/task.md) | `Task.h` | 任务基类 |
| [LambdaTask](lambdatask/lambdatask.md) | `LambdaTask.h` | Lambda 任务封装模板 |
| [TaskGroup](task-group/task-group.md) | `TaskGroup.h` | 任务组 |
| [TaskSystem](task-system/task-system.md) | `TaskSystem.h` | 并行任务调度系统 |
| [TaskSystemConfig](tasksystemconfig/tasksystemconfig.md) | `TaskSystemConfig.h` | 任务系统配置 |

## 同步原语对比

| 原语 | 适用场景 | 特点 |
|------|----------|------|
| `Mutex` | 一般互斥 | 可重入性差，开销适中 |
| `SpinLock` | 短临界区 | 无系统调用，开销低 |
| `ReadWriteLock` | 读多写少 | 读写分离，提高并发 |

## 任务系统使用示例

```cpp
#include "Threading/TaskSystem.h"

// 初始化任务系统
TaskSystemConfig config;
config.workerThreadCount = 4;
TaskSystem::Get().Initialize(config);

// 提交并行任务
TaskSystem::Get().Submit([]() {
    // 执行工作
});

// 使用任务组
TaskGroup* group = TaskSystem::Get().CreateTaskGroup();
group->AddTask([]() { /* 任务1 */ });
group->AddTask([]() { /* 任务2 */ });
group->Wait();

// 销毁任务组
TaskSystem::Get().DestroyTaskGroup(group);
```

## 相关文档

- [Memory 模块](../memory/memory.md) - 内存分配器