2025年汽车行业技术部工程师代码审查记录手册.docxVIP

2025年汽车行业技术部工程师代码审查记录手册

第1章代码规范与静态分析配置

1.1统一代码风格与命名规则

在Python项目中，严格遵循PEP8规范以确保代码可读性与一致性，所有文件必须包含`__init__.py`文件以明确模块边界，并统一使用`pylint`工具进行行内代码检查，确保缩进使用4个空格而非制表符，避免混用2个空格或制表符。函数命名必须遵循“动词+名词”结构，且首字母大写，例如`calculate_total_price`而不是`calc_total_price`，同时函数内部参数需按定义顺序排列，如`defprocess_data(data,filter_by_category=None,threshold=0.01):`。

类名命名应使用PascalCase风格，区分大小写，且类名需包含业务语义，例如`OrderManager`而非`OrderMgr`，并在类内部保持成员变量命名小写加下划线，如`order_id`和`total_amount`。所有全局变量必须定义为`dataclass`或在类中显式声明，禁止使用`global`关键字，例如`dataclass(dataclass_params=[id,name,created_at])classUser:`，避免