docs/api/threading/task-system-config/max-task-queue-size.md

# TaskSystemConfig::maxTaskQueueSize

```cpp
uint32_t maxTaskQueueSize = 1024
```

任务队列的最大容量。当队列满时，新提交的任务将阻塞直到有空间。

**类型：** `uint32_t`

**默认值：** `1024`

**当前状态：** 此配置项当前未实际强制限制，任务队列可以无限增长（受系统内存限制）。

**示例：**

```cpp
TaskSystemConfig config;
config.maxTaskQueueSize = 4096; // 预留配置项（当前未强制限制）
```

## 相关文档

- [TaskSystemConfig 总览](tasksystemconfig.md) - 返回类总览
docs: 重构 API 文档结构并修正源码准确性 - 重组文档目录结构: 每个模块的概述页移动到模块子目录 - 重命名 index.md 为 main.md - 修正所有模块文档中的错误: - math: FromEuler→FromEulerAngles, TransformDirection 包含缩放, Box 是 OBB, Color::ToRGBA 格式 - containers: 新增 operator==/!= 文档, 补充 std::hash DJB 算法细节 - core: 修复 types 链接错误 - debug: LogLevelToString 返回大写, timestamp 是秒, Profiler 空实现标注, Windows API vs ANSI - memory: 修复头文件路径, malloc vs operator new, 新增方法文档 - resources: 修复 Shader/Texture 链接错误 - threading: TaskSystem::Wait 空实现标注, ReadWriteLock 重入描述, LambdaTask 链接 - 验证: fix_links.py 确认 0 个断裂引用 2026-03-19 00:22:30 +08:00			`# TaskSystemConfig::maxTaskQueueSize`

			```cpp
			`uint32_t maxTaskQueueSize = 1024`
			```

			`任务队列的最大容量。当队列满时，新提交的任务将阻塞直到有空间。`

			类型： `uint32_t`

			默认值： `1024`

docs: 修正 API 文档准确性 (第二轮检查) 修复的问题: - math: 修复 Quaternion::Normalize 链接错误 - containers: HashMap 迭代器示例使用不存在的 cbegin/cend，删除冗余构造函数声明 - core: RefCounted 析构函数访问级别修正 (protected) - debug: LogLevelToString 示例返回值大小写修正 - memory: 修正 LinearAllocator::Reallocate 返回 nullptr，ProxyAllocator 统计描述，头文件路径 IAllocator.h -> Allocator.h - resources: Texture::Create mipLevels 参数描述修正 - rhi: 修复多处链接错误，新增缺失的方法文档 - threading: TaskSystem 配置项未实现状态标注，Wait 方法空实现标注 2026-03-19 00:31:14 +08:00			`当前状态：此配置项当前未实际强制限制，任务队列可以无限增长（受系统内存限制）。`

docs: 重构 API 文档结构并修正源码准确性 - 重组文档目录结构: 每个模块的概述页移动到模块子目录 - 重命名 index.md 为 main.md - 修正所有模块文档中的错误: - math: FromEuler→FromEulerAngles, TransformDirection 包含缩放, Box 是 OBB, Color::ToRGBA 格式 - containers: 新增 operator==/!= 文档, 补充 std::hash DJB 算法细节 - core: 修复 types 链接错误 - debug: LogLevelToString 返回大写, timestamp 是秒, Profiler 空实现标注, Windows API vs ANSI - memory: 修复头文件路径, malloc vs operator new, 新增方法文档 - resources: 修复 Shader/Texture 链接错误 - threading: TaskSystem::Wait 空实现标注, ReadWriteLock 重入描述, LambdaTask 链接 - 验证: fix_links.py 确认 0 个断裂引用 2026-03-19 00:22:30 +08:00			`示例：`

			```cpp
			`TaskSystemConfig config;`
docs: 修正 API 文档准确性 (第二轮检查) 修复的问题: - math: 修复 Quaternion::Normalize 链接错误 - containers: HashMap 迭代器示例使用不存在的 cbegin/cend，删除冗余构造函数声明 - core: RefCounted 析构函数访问级别修正 (protected) - debug: LogLevelToString 示例返回值大小写修正 - memory: 修正 LinearAllocator::Reallocate 返回 nullptr，ProxyAllocator 统计描述，头文件路径 IAllocator.h -> Allocator.h - resources: Texture::Create mipLevels 参数描述修正 - rhi: 修复多处链接错误，新增缺失的方法文档 - threading: TaskSystem 配置项未实现状态标注，Wait 方法空实现标注 2026-03-19 00:31:14 +08:00			`config.maxTaskQueueSize = 4096; // 预留配置项（当前未强制限制）`
docs: 重构 API 文档结构并修正源码准确性 - 重组文档目录结构: 每个模块的概述页移动到模块子目录 - 重命名 index.md 为 main.md - 修正所有模块文档中的错误: - math: FromEuler→FromEulerAngles, TransformDirection 包含缩放, Box 是 OBB, Color::ToRGBA 格式 - containers: 新增 operator==/!= 文档, 补充 std::hash DJB 算法细节 - core: 修复 types 链接错误 - debug: LogLevelToString 返回大写, timestamp 是秒, Profiler 空实现标注, Windows API vs ANSI - memory: 修复头文件路径, malloc vs operator new, 新增方法文档 - resources: 修复 Shader/Texture 链接错误 - threading: TaskSystem::Wait 空实现标注, ReadWriteLock 重入描述, LambdaTask 链接 - 验证: fix_links.py 确认 0 个断裂引用 2026-03-19 00:22:30 +08:00			```

			`## 相关文档`

			`- [TaskSystemConfig 总览](tasksystemconfig.md) - 返回类总览`