Web前端代码规范

本规范为团队开发提供统一的代码风格指南,涵盖HTML、CSS和JavaScript,以提高代码可读性、可维护性和协作效率。

### HTML规范

  • 语义化标签: 使用语义化的HTML标签,例如
  • 属性顺序: HTML属性应该按照特定的顺序排列,例如 class 在前, id 在后。
  • 代码缩进: 使用两个空格进行代码缩进,保持代码结构清晰。

### CSS规范

  • 命名规范: 采用连字符命名法(kebab-case)命名类名,例如 .product-card
  • 选择器嵌套: 避免过深的CSS选择器嵌套,建议不超过三层。
  • 属性顺序: CSS属性应该按照逻辑分组并排序,例如布局属性在前,排版属性在后。

### JavaScript规范

  • 变量命名: 采用驼峰命名法(camelCase)命名变量和函数名。
  • 代码注释: 为复杂逻辑和函数添加清晰简洁的注释。
  • 错误处理: 使用 try...catch 语句进行错误处理,避免代码异常中断。

## 总结

遵循一致的代码规范对于团队合作至关重要,它可以减少代码冲突、提高代码质量,并降低维护成本。