代码模块化阈值

概述

UrhoX 大型项目开发中，单文件代码行数超过阈值时必须拆分为多模块，以保证可维护性和 AI 开发效率。

关键内容

1. 行数阈值：< 1000 行单文件可接受；1000-1500 行考虑拆分，提取独立模块；> 1500 行必须拆分为多个模块。
2. 何时开始模块化：一次性小游戏/Demo 单文件即可；需要多轮对话迭代的项目从第一轮就建立模块化结构；现有代码接近 1000 行时主动提议拆分。
3. 参考示例：examples/07-minecraft-voxel-world 是多文件模块化架构的最佳实践示例，展示了大型项目的文件组织方式。

来源

• raw/articles/personal/ai-dev-kit/CLAUDE.md — UrhoX Lua AI 开发指南，规则 #13

相关

• UrhoX引擎 — relates_to（宿主引擎）
• Lua模块系统 — relates_to（模块化实现方式）
• 游戏脚手架模式 — relates_to（脚手架是模块化的起点）