命名规范 📚
- 变量名:使用小写字母和下划线,如
user_name
- 函数名:动词+名词结构,如
calculate_total()
- 类名:使用大驼峰命名法,如
UserProfile
代码结构 🧱
- 每个函数控制单一职责
- 使用空行分隔逻辑块
- 避免过度嵌套(>3层时需重构)
注释规范 📖
- 关键逻辑需添加注释
- 使用英文文档注释(
#
) - 避免冗余注释(如
i++
无需注释)
格式化建议 📏
- 缩进使用4空格
- 每行不超过80字符
- 操作符后添加空格(如
x = 5 + 3
) - 代码块使用 ```markdown 包裹
需要了解更多代码质量标准?可访问 code_quality 进行扩展阅读 🚀