3.1.1 目录结构约定

文档摘要

3.1.1 目录结构约定在工程实践中，目录结构从来不是一张静态的树状快照，而是一套可执行、可验证、可演化、可审计的契约协议——它定义了人与机器如何协同理解代码意图，规定了IDE如何索引符号、CI如何分片构建、包管理器如何解析依赖、静态分析工具如何定位上下文，甚至决定了新成员入职第三小时能否准确找到模块的JWT签发逻辑。我们常把“目录结构”挂在嘴边，却极少追问：当下突然多出一个时，是技术债的自然沉淀，还是结构契约已被无声撕毁？当里混入了三个不同测试框架的配置文件，是灵活性的胜利，还是约定失效的前兆？本节不谈“应该长什么样”，只聚焦于——如何让目录结构从模糊共识，变成可落地、可检测、可强制、可演进的技术契约。