Python变量与命名规范从入门到精通(最新推荐)

# 变量的基本赋值
message = "Hello, Python"  # 字符串类型
count = 42                  # 整数类型
price = 19.99               # 浮点类型
is_valid = True             # 布尔类型

# 变量是对象的引用
a = [1, 2, 3]  # a 引用了列表对象
b = a          # b 引用了同一个列表对象
b.append(4)    # 修改b指向的列表
print(a)       # 输出: [1, 2, 3, 4] - a也改变了！
# 验证内存地址
print(id(a))   # 输出内存地址
print(id(b))   # 与a相同，证明指向同一对象

# 变量的类型可以动态改变
x = 10          # x是整数
print(type(x))  # <class 'int'>
x = "Hello"     # x现在是字符串
print(type(x))  # <class 'str'>
x = [1, 2, 3]   # x现在是列表
print(type(x))  # <class 'list'>

# 多重赋值
a, b, c = 1, 2, 3
print(a, b, c)  # 1 2 3
# 交换变量 - Python特色语法
x, y = 10, 20
x, y = y, x     # 优雅地交换
print(x, y)     # 20 10
# 序列解包
numbers = [1, 2, 3]
first, second, third = numbers
print(first)    # 1
# 使用星号收集剩余元素
first, *rest, last = [1, 2, 3, 4, 5]
print(first)    # 1
print(rest)     # [2, 3, 4]
print(last)     # 5

# LEGB规则：Local -> Enclosing -> Global -> Built-in
global_var = "全局变量"  # 全局作用域
def outer_function():
    enclosing_var = "嵌套变量"  # 嵌套作用域
    def inner_function():
        local_var = "局部变量"  # 局部作用域
        print(local_var)
        print(enclosing_var)    # 可以访问外层变量
        print(global_var)       # 可以访问全局变量
    inner_function()
outer_function()

# 常量通常用大写字母命名
MAX_CONNECTIONS = 1000
DEFAULT_TIMEOUT = 30
PI = 3.14159
# 注意：这仍然是变量，可以修改，但不应该修改
MAX_CONNECTIONS = 2000  # 技术上可行，但违反约定

# 不好的命名
a = "张三"
b = 25
c = True
# 好的命名
user_name = "张三"
user_age = 25
is_active = True

# 不好的命名
usr_cnt = 10
txt = "Hello"
val = calculate()
# 好的命名
user_count = 10
message_text = "Hello"
result = calculate()

# 不好的函数命名
def name():
    return user.name
def data():
    return fetch_data()
# 好的函数命名
def get_user_name():
    return user.name
def fetch_user_data():
    return fetch_data()

# 布尔变量通常用is/has/can开头
is_authenticated = True
has_permission = False
can_edit = True
is_visible = False

# 循环计数器
for i in range(10):  # i, j, k 常用于循环计数
    print(i)
# 数学公式
for x, y in points:  # x, y 常用于坐标
    distance = (x**2 + y**2)**0.5
# 临时变量
_, value = get_pair()  # _ 表示我们不关心的值

class User:
    def __init__(self, name):
        self.name = name           # 公有属性
        self._internal_id = 123    # 私有属性（约定）
        self.__password = "secret" # 名称修饰（避免子类冲突）
    def _internal_method(self):    # 私有方法
        pass
    def __str__(self):             # 魔术方法
        return self.name
# 访问测试
user = User("Alice")
print(user.name)           # 可以访问
print(user._internal_id)   # 技术上可以访问，但不应该
# print(user.__password)   # 报错：属性不存在
print(user._User__password) # 名称修饰后的实际名称

from typing import List, Optional
# 带类型注解的变量
name: str = "Alice"
age: int = 30
scores: List[float] = [95.5, 87.0, 92.5]
# 函数参数和返回值类型注解
def greet(user_name: str, is_formal: bool = False) -> str:
    """生成问候语"""
    prefix = "Dear" if is_formal else "Hello"
    return f"{prefix} {user_name}"
# Optional表示可能为None
def find_user(user_id: int) -> Optional[dict]:
    # 返回用户字典或None
    pass

# Django框架
class BlogPost(models.Model):
    title = models.CharField(max_length=200)
    publish_date = models.DateTimeField()  # 下划线命名
    def get_absolute_url(self):  # 特定方法名
        return f"/post/{self.id}/"
# Flask框架
app = Flask(__name__)
@app.route('/users/<int:user_id>')
def get_user_profile(user_id):  # 函数名明确
    return render_template('profile.html')
# 数据科学（Pandas）
df_users = pd.read_csv('users.csv')  # df_前缀表示DataFrame

# 重构前
temp = calculate_average(scores)
if temp > 60:
    print("Pass:", temp)
# 重构后 - 使用更有意义的名称
average_score = calculate_average(scores)
if average_score > 60:
    print("Pass:", average_score)

# 代码气味1：魔法数字
def calculate_price(quantity):
    return quantity * 299  # 299是什么？
# 改进
PRODUCT_PRICE = 299
def calculate_price(quantity):
    return quantity * PRODUCT_PRICE
# 代码气味2：过长参数列表
def process(name, age, email, phone, address, city, country, zipcode):
    pass
# 改进
class UserData:
    def __init__(self, name, age, email, phone, address):
        self.name = name
        # ...
def process(user_data: UserData):
    pass

# 不好的实现
class user:
    def __init__(self, n, a):
        self.n = n  # name
        self.a = a  # age
        self.s = True  # status
    def g_n(self):
        return self.n
# 好的实现
class User:
    """用户类"""
    def __init__(self, name: str, age: int):
        self.name = name
        self.age = age
        self.is_active = True  # 状态名清晰
    def get_name(self) -> str:
        """获取用户名"""
        return self.name
    def deactivate(self):
        """停用用户"""
        self.is_active = False

class ShoppingCart:
    def __init__(self):
        self._items = []  # 私有属性
        self.total_price = 0.0
    def add_item(self, item_name: str, price: float, quantity: int = 1):
        """添加商品到购物车"""
        for _ in range(quantity):
            self._items.append(item_name)
        self.total_price += price * quantity
    def get_item_count(self) -> int:
        """获取商品总数"""
        return len(self._items)
    def is_empty(self) -> bool:
        """判断购物车是否为空"""
        return len(self._items) == 0
# 使用示例
cart = ShoppingCart()
cart.add_item("Python编程", 89.00, 2)
cart.add_item("机械键盘", 299.00)
if not cart.is_empty():
    print(f"购物车共{cart.get_item_count()}件商品")
    print(f"总价: ¥{cart.total_price}")

# pylint - 检查命名规范
pip install pylint
pylint your_script.py
# flake8 - 综合检查
pip install flake8
flake8 your_script.py
# black - 自动格式化
pip install black
black your_script.py