13. 避免过多的参数
函数或方法的参数应该尽可能少,过多的参数会使得函数难以理解和使用。
不整洁(错误):
def create_user(name, age, gender, email, phone, address, country, state, city, zip_code):
pass
整洁(正确):
class User:
def __init__(self, name, age, gender, email, phone, address):
pass
# 或者使用字典或其他结构来封装参数
def create_user(user_data):
pass
修复说明:
- 使用类或数据结构来封装相关的参数,减少函数签名的复杂度。
14. 使用描述性的变量名
变量名应该清晰地描述变量的用途。
不整洁(错误):
a = 3.14 # 什么是a?
r = 5
area = a * r * r
整洁(正确):
PI = 3.14
radius = 5
circle_area = PI * radius * radius
修复说明:
- 使用具有描述性的变量名代替模糊的单字母变量名。
15. 避免不必要的全局变量
全局变量应该被视为最后的选择,因为它们可能导致代码难以追踪和维护。
不整洁(错误):
# 某个全局变量
user_count = 0
def increment_user_count():
global user_count
user_count += 1
整洁(正确):
class UserCounter:
def __init__(self):
self.count = 0
def increment(self):
self.count += 1
修复说明:
- 使用类或其他封装方法来管理原本由全局变量承担的状态。