8.3.1 项目目录结构规范

文档摘要

8.3.1 项目目录结构规范在软件工程的漫长实践中，我们曾无数次目睹一个项目从意气风发的“Hello World”起步，却在三个月后陷入目录泥潭： , , , , , , , , , , , , , , , , , , , , ……这些文件夹名像雨后春笋般冒出，又如雾中楼阁般彼此重叠。开发者打开项目根目录时，不是在导航代码，而是在解谜——谜面是“这个函数该放在哪”，谜底却是“昨天我把它放错了，今天我得先找到它，再决定要不要挪”。这不是偶然，而是系统性失范的必然结果。目录结构从来不是静态的容器，而是运行时依赖关系的静态投影、编译期模块边界的显式声明、团队认知负荷的物理载体、CI/CD流水线可预测性的底层契约。