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

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

第1章基础规范与编码风格

1.1项目编码规则与命名约定

所有Java类名必须采用大驼峰命名法（PascalCase），例如`UserServiceImpl`，类名需直接反映其业务职责，如`InventoryManager`或`OrderProcessor`，避免使用`ServiceImpl`等通用后缀，确保类名在IDE中搜索即可定位。接口类名也遵循大驼峰命名法，例如`UserApiService`，而具体的实现类名则统一使用小驼峰命名法（camelCase），例如`UserServiceImpl`，这种区分能清晰界定接口层与实现层的职责边界。

包名（Package）必须严格对应项目的顶层目录结构，例如`com.example.aip`对应`src/main/java/com/example/aip`，包名中禁止包含空格，且必须使用下划线分隔，如`userService`而非`user_service`。所有私有方法（private）和私有静态方法（static）的访问修饰符必须严格限定为`private`，严禁使用`package-private`或`default`，以杜绝外部类直接调用内部逻辑的风险，降低代码耦合度。在SpringBoot项目中，所有配置类（Confi