Puppet模块manifest子目录是否需对应同名类文件？

这是Puppet社区广泛遵循的约定俗成的规范，而非官方强制要求的规则，它的存在主要是为了提升模块的可读性和维护性，但也存在不遵循的合理场景。

约定规范的核心逻辑 #

• 命名空间与文件结构对齐：比如firewall模块下的manifest/linux/子目录，搭配同名的linux.pp文件定义firewall::linux类，能让类的命名空间和文件系统路径一一对应，其他开发者看到类名就能立刻找到对应的代码位置，大幅降低维护成本。
• 兼容自动加载机制：Puppet默认的类自动加载规则是根据文件路径推断类名，modules/[模块名]/manifest/[路径].pp会被解析为[模块名]::[路径]类。同名文件的存在能确保父类被正确加载，避免子目录中依赖父类的子类出现加载顺序问题。

不遵循该规范的常见场景 #

• 小型或单一用途子目录：如果子目录里仅包含1-2个细分类（比如firewall::linux::allow_ssh），且不需要对外暴露firewall::linux这个父类接口，就没必要单独创建linux.pp文件。
• 自定义加载逻辑：部分模块会通过配置autoload参数或自定义函数来控制类的加载，这种情况下可以绕开默认的文件-类名对应规则。
• 旧版本遗留代码：早期Puppet版本对自动加载的约束较弱，一些维护多年的老模块可能保留了不遵循该约定的写法。

实践建议 #

• 新项目或新开发的模块，尽量遵循这个约定，能提升团队协作效率，也符合社区主流的代码风格。
• 维护已有旧模块时，如果已经存在不遵循规范的写法，除非有明确的重构需求，否则无需强行修改，避免引入不必要的风险。

内容的提问来源于stack exchange，提问作者waitillogical