2025年互联网行业技术部工程师代码规范维护手册.docx

2025年互联网行业技术部工程师代码规范维护手册

第1章代码结构与组织

1.1项目目录规范

建立基于语义化的层级目录结构，核心原则是“职责单一”，确保每个文件夹或文件仅负责一项具体功能，避免目录混乱。严格遵循src与docs分离原则，将置于src目录下，文档（如API说明、部署文档）置于docs目录下，严禁在源码目录中直接存放或TXT文件。

实施严格的命名约定，所有文件必须包含语言前缀（如Python文件以.py结尾，Java文件以.class结尾），且文件名长度控制在1-10个字符之间，避免使用空格或特殊字符。规范版本控制前缀，所有提交文件必须使用语