2025年软件行业测试部测试员代码质量手册.docxVIP

2025年软件行业测试部测试员代码质量手册

第1章代码规范与静态检查

1.1项目级编码规范

本章节旨在确立2025年软件测试部所有开发人员必须遵循的底层行为准则，确保代码的可维护性与一致性。

所有函数必须遵循单一职责原则（SRP），禁止在单个函数内混用超过三种不同的业务逻辑，例如禁止在`calculateTax`函数中同时处理税率计算和发票打印逻辑，而应将发票打印逻辑移至独立的`printInvoice`函数中。变量命名必须严格遵循“驼峰命名法”（CamelCase），且必须包含描述性前缀，如`user_id`而非`uid`，`request_timeout`而非`req_time`，以确保代码在缺乏上下文时仍能通过语义理解其用途。

所有公共接口函数必须返回`Promise`或明确抛出`Error`对象，禁止使用隐式`return`或`null`返回值，特别是在处理异步操作时，必须使用`async`/`await`模式保证线程安全。文件命名必须采用`snake_case`小写下划线分隔符，且文件名即函数名，例如`utils.js`对应`utils.js`，禁止出现`helper.js`或`util.js`等冗余命名，以简化IDE的自动补全体验。必须使用ESLint和Prettier插件进行