2025年汽车行业研发部研发工程师代码编写手册.docxVIP

2025年汽车行业研发部研发工程师代码编写手册

第1章基础规范与安全编码

1.1项目代码架构与目录结构

本章节旨在确立2025年研发部代码的“单一提交单元”原则，通过强制统一的目录结构，确保新入职工程师无需查阅复杂手册即可理解项目整体逻辑。所有功能模块必须严格遵循`src/main/java/[模块名]/[类名].java`的命名规范，禁止在同一个模块内混用过度嵌套的目录，防止因路径过长导致的IDE索引失效和维护困难。必须严格执行分层架构规范，将代码划分为Controller（控制器）、Service（业务逻辑层）、Repository（数据访问层）和Model（数据模型层），并在根目录下建立独立的`src/test/java`和`src/integration/java`测试目录，严禁将测试代码直接嵌入生产代码目录中，以保障代码的可读性和测试的独立性。

引入Git分支管理策略，规定开发阶段使用`dev`分支，合并后自动切换至`main`分支，禁止直接在`main`分支上进行开发或提交；所有涉及核心业务逻辑的代码变更必须经过代码审查（CodeReview）流程，并附带详细的变更说明文档，确保版本迭代的可追溯性。建立清晰的包名规范，遵循`company.module.submodule.packageName`的层级结构，