软件行业开发部开发工程师前端开发规范手册.docxVIP

软件行业开发部开发工程师前端开发规范手册

第1章基本规范

1.1代码风格

代码风格决定了一个项目能否被高效维护，甚至影响团队协作的流畅度。缺乏统一规范的代码，如同杂乱无章的建筑图纸，最终导致开发成本指数级上升。

缩进与空格：使用4个空格作为缩进单位，而非tab键。统一缩进能显著提升代码的可读性，尤其是在嵌套层级较深时。例如，React组件的`render`方法中，每个逻辑块保持一致的缩进，能让人一眼看出控制流走向。

命名约定：

-变量名和函数名采用`camelCase`（如`calculateTotalPrice`），避免`total_price`这种蛇形命名，它更适用于后端API设计。

-类名使用`PascalCase`（如`UserProfile`），与组件库（如AntDesign）保持一致，避免视觉混乱。

-常量名全大写并下划线分隔（如`MAX_TIMEOUT`），确保其在全局作用域中一目了然。

代码行宽：建议限制在80-100字符内。过长的一行代码会迫使开发者水平滚动，破坏阅读体验。例如，CSS中的媒体查询若超过100字符，可拆分为多行：

media(max-width:768px){

.sidebar{

display:none;

}

}

函数长度：单个函数应聚焦于一项任务。超过50行的函数，几乎肯