2025年汽车行业技术部软件工程师代码编写规范手册.docxVIP

2025年汽车行业技术部软件工程师代码编写规范手册

第1章

项目结构与代码组织规范

1.1根目录文件体系定义

根目录必须严格遵循src/main/java,src/main/resources,src/test/java,src/test/resources的四分区结构，这是构建系统（如Maven或Gradle）识别项目入口的绝对依据，任何文件不得跨区放置。根目录下禁止存放二进制文件（如.class,.exe,.apk）及操作系统核心文件（如.dll,.so），确保运行时环境纯净，防止因文件扩展名混淆导致的编译错误。

根目录下的pom.xml（Maven）或build.gradle（Gradle）文件必须包含完整的插件配置、依赖树及版本约束，作为整个项目的“宪法”，任何子模块的修改不得破坏其顶层逻辑。根目录下应包含.gitignore或.gitattributes配置文件，明确声明哪些文件（如.gitignore）用于忽略版本控制，哪些文件（如.gitattributes）用于指定编码格式，防止Git仓库被污染。根目录下需配置IDE插件初始化脚本（如IntelliJIDEA的runIde或VSCode的.vscode/settings.json），确保开发者进入项目后能自动加载配置、打开调试窗口并解析