类变量和实例变量的命名规范有哪些具体的例子？

类变量和实例变量的命名核心遵循 Python PEP 8 规范蛇形命名、见名知意但因归属和用途不同命名风格有明确区分。下面结合具体场景 可直接复用的示例讲透两类变量的命名规范包括普通变量、常量、私有变量等场景。一、通用命名基础所有变量必遵守先明确通用规则示例均符合以下要求小写字母 下划线分隔蛇形命名snake_case见名知意避免单字母i/x等通用缩写除外不使用关键字、魔法属性如__init__不以数字开头不含特殊字符。二、类变量命名规范 具体示例类变量是「类的共享属性」命名需突出「全局 / 共享 / 常量 / 统计」特性分 3 类场景表格类变量类型命名规则正面示例推荐反面示例避坑普通共享类变量蛇形命名体现 “共享 / 统计” 语义total_users总用户数default_timeout默认超时class_name班级名pass_rate通过率totalUsers驼峰命名tu无意义缩写123count数字开头class关键字常量类变量全大写 下划线体现 “不可修改”MAX_RETRY 3最大重试次数DEFAULT_PORT 8080默认端口SPECIES 人类物种MAX_SCORE 100满分maxRetry 3驼峰 小写max_score 3全小写无常量标识MaxScore 3混合大小写私有类变量单下划线开头 蛇形命名约定私有_internal_cache内部缓存_temp_data临时数据_grade_mapping年级映射__internal_cache双下划线触发名称改写InternalCache大驼峰_Internal_Cache混合大小写完整示例类变量命名python运行class OrderSystem: # 常量类变量全大写 MAX_ORDER_ITEMS 20 # 订单最大商品数 DEFAULT_EXPIRE_HOURS 24 # 订单默认过期小时数 PAYMENT_TYPES [alipay, wechat] # 支持的支付方式 # 普通共享类变量蛇形命名 total_orders 0 # 总订单数 pending_orders 0 # 待处理订单数 system_version 2.1.0 # 系统版本 # 私有类变量单下划线开头 _order_status_mapping {0: 待支付, 1: 已支付, 2: 已取消} # 订单状态映射 _debug_mode False # 调试模式 def create_order(self): # 修改普通类变量 OrderSystem.total_orders 1 OrderSystem.pending_orders 1三、实例变量命名规范 具体示例实例变量是「单个实例的独有属性」命名需突出「个体特征 / 状态」分 3 类场景表格实例变量类型命名规则正面示例推荐反面示例避坑普通实例变量蛇形命名体现 “实例独有” 语义user_id 1001用户 IDorder_id ORD20250501订单 IDphone_number 13800138000手机号shipping_address 北京市朝阳区收货地址userID 1001驼峰uid 1001无意义缩写PhoneNumber 138...大驼峰私有实例变量单下划线开头 蛇形命名约定私有_password abc123密码_login_token token123登录令牌_internal_state init内部状态__password双下划线慎用_Password首字母大写_pass_word过度拆分强私有实例变量双下划线开头慎用防止子类覆盖__secret_key xxx加密密钥__transaction_id trans123交易流水号___secret_key多下划线__SecretKey混合大小写__secret-key含连字符完整示例实例变量命名python运行class User: # 类变量常量 MIN_AGE 18 # 最小注册年龄 def __init__(self, user_id, username, phone): # 普通实例变量 self.user_id user_id # 用户ID self.username username # 用户名 self.phone_number phone # 手机号 self.age None # 年龄 self.register_time None # 注册时间 self.is_active True # 是否激活 # 私有实例变量单下划线 self._email None # 邮箱私有外部不建议访问 self._login_count 0 # 登录次数私有 # 强私有实例变量双下划线慎用 self.__password_hash None # 密码哈希防止子类覆盖 def set_email(self, email): # 类内操作私有实例变量 self._email email def update_password(self, new_hash): self.__password_hash new_hash四、避坑补充易混淆的命名场景类变量 vs 实例变量同名禁止避免类变量和实例变量同名否则实例访问时优先读实例变量逻辑混乱python运行class BadExample: name 默认名 # 类变量 def __init__(self, name): self.name name # 实例变量与类变量同名易混淆 # 推荐改为类变量用 default_name实例变量用 name class GoodExample: default_name 默认名 # 类变量 def __init__(self, name): self.name name # 实例变量可变类型类变量命名可变类型列表 / 字典的类变量命名仍遵循类变量规则仅语义体现 “集合 / 映射”python运行class Cart: DEFAULT_ITEMS [购物袋] # 常量全大写 _hot_items [纸巾, 矿泉水] # 私有类变量单下划线 user_cart_count 0 # 普通类变量五、总结命名规范核心表格变量类型核心命名规则关键示例类变量普通蛇形常量全大写私有单下划线total_users、MAX_RETRY、_internal_cache实例变量普通蛇形私有单下划线强私有双下划线phone_number、_password、__secret_key遵循以上示例既能符合 PEP 8 标准又能让开发者一眼区分变量归属类 / 实例和用途常量 / 私有 / 普通大幅提升代码可读性。ZiyEchaiCFu.cOmwww.ZiyEchaiCFu.cOma1b2.ZiyEchaiCFu.cOmsky07.ZiyEchaiCFu.cOmrun89.ZiyEchaiCFu.cOmlink22.ZiyEchaiCFu.cOmcool56.ZiyEchaiCFu.cOmfast31.ZiyEchaiCFu.cOmstar44.ZiyEchaiCFu.cOmzone78.ZiyEchaiCFu.cOmnet19.ZiyEchaiCFu.cOmtop63.ZiyEchaiCFu.cOmfire27.ZiyEchaiCFu.cOmsoft51.ZiyEchaiCFu.cOmpage35.ZiyEchaiCFu.cOmlive81.ZiyEchaiCFu.cOmdata04.ZiyEchaiCFu.cOmtool66.ZiyEchaiCFu.cOmhub29.ZiyEchaiCFu.cOmwave53.ZiyEchaiCFu.cOmpeak12.ZiyEchaiCFu.cOmsmart77.ZiyEchaiCFu.cOmmeta33.ZiyEchaiCFu.cOmflow48.ZiyEchaiCFu.cOmcore09.ZiyEchaiCFu.cOmwave21.ZiyEchaiCFu.cOmmint69.ZiyEchaiCFu.cOmtech15.ZiyEchaiCFu.cOmbyte42.ZiyEchaiCFu.cOmgrid58.ZiyEchaiCFu.cOmpool37.ZiyEchaiCFu.cOmkey84.ZiyEchaiCFu.cOmraw06.ZiyEchaiCFu.cOmclip61.ZiyEchaiCFu.cOmnest24.ZiyEchaiCFu.cOmpure55.ZiyEchaiCFu.cOmrack17.ZiyEchaiCFu.cOmdash72.ZiyEchaiCFu.cOmfold39.ZiyEchaiCFu.cOmmint46.ZiyEchaiCFu.cOmiron02.ZiyEchaiCFu.cOmvein64.ZiyEchaiCFu.cOmglow26.ZiyEchaiCFu.cOmpath52.ZiyEchaiCFu.cOmhive14.ZiyEchaiCFu.cOmdrift79.ZiyEchaiCFu.cOmslot32.ZiyEchaiCFu.cOmbulk49.ZiyEchaiCFu.cOmbond08.ZiyEchaiCFu.cOmgaze67.ZiyEchaiCFu.cOmrust23.ZiyEchaiCFu.cOmveil57.ZiyEchaiCFu.cOmbook.ZiyEchaiCFu.cOm/article/B2c3D4e5F6.htmlbook.ZiyEchaiCFu.cOm/article/C3d4E5f6G7.htmlbook.ZiyEchaiCFu.cOm/article/D4e5F6g7H8.htmlbook.ZiyEchaiCFu.cOm/article/E5f6G7h8I9.htmlbook.ZiyEchaiCFu.cOm/article/F6g7H8i9J0.htmlbook.ZiyEchaiCFu.cOm/article/G7h8I9j0K1.htmlbook.ZiyEchaiCFu.cOm/article/H8i9J0k1L2.htmlbook.ZiyEchaiCFu.cOm/article/I9j0K1l2M3.htmlbook.ZiyEchaiCFu.cOm/article/J0k1L2m3N4.htmlbook.ZiyEchaiCFu.cOm/article/K1l2M3n4O5.htmlbook.ZiyEchaiCFu.cOm/article/L2m3N4o5P6.htmlbook.ZiyEchaiCFu.cOm/article/M3n4O5p6Q7.htmlbook.ZiyEchaiCFu.cOm/article/N4o5P6q7R8.htmlbook.ZiyEchaiCFu.cOm/article/O5p6Q7r8S9.htmlbook.ZiyEchaiCFu.cOm/article/P6q7R8s9T0.htmlbook.ZiyEchaiCFu.cOm/blog/Q7r8S9t0U1.htmlbook.ZiyEchaiCFu.cOm/blog/R8s9T0u1V2.htmlbook.ZiyEchaiCFu.cOm/blog/S9t0U1v2W3.htmlbook.ZiyEchaiCFu.cOm/blog/T0u1V2w3X4.htmlbook.ZiyEchaiCFu.cOm/blog/U1v2W3x4Y5.htmlbook.ZiyEchaiCFu.cOm/blog/V2w3X4y5Z6.htmlbook.ZiyEchaiCFu.cOm/blog/W3x4Y5z6A7.htmlbook.ZiyEchaiCFu.cOm/blog/X4y5Z6a7B8.htmlbook.ZiyEchaiCFu.cOm/blog/Y5z6A7b8C9.htmlbook.ZiyEchaiCFu.cOm/blog/Z6a7B8c9D0.htmlbook.ZiyEchaiCFu.cOm/article/a7B8c9D0e1.htmlbook.ZiyEchaiCFu.cOm/article/b8C9d0E1f2.htmlbook.ZiyEchaiCFu.cOm/article/c9D0e1F2g3.htmlbook.ZiyEchaiCFu.cOm/article/d0E1f2G3h4.htmlbook.ZiyEchaiCFu.cOm/article/e1F2g3H4i5.htmlbook.ZiyEchaiCFu.cOm/article/f2G3h4I5j6.htmlbook.ZiyEchaiCFu.cOm/article/g3H4i5J6k7.htmlbook.ZiyEchaiCFu.cOm/article/h4I5j6K7l8.htmlbook.ZiyEchaiCFu.cOm/article/i5J6k7L8m9.htmlbook.ZiyEchaiCFu.cOm/article/j6K7l8M9n0.htmlbook.ZiyEchaiCFu.cOm/article/k7L8m9N0o1.htmlbook.ZiyEchaiCFu.cOm/article/l8M9n0O1p2.htmlbook.ZiyEchaiCFu.cOm/article/m9N0o1P2q3.htmlbook.ZiyEchaiCFu.cOm/article/n0O1p2Q3r4.htmlbook.ZiyEchaiCFu.cOm/article/o1P2q3R4s5.htmlbook.ZiyEchaiCFu.cOm/article/p2Q3r4S5t6.htmlbook.ZiyEchaiCFu.cOm/article/q3R4s5T6u7.htmlbook.ZiyEchaiCFu.cOm/article/r4S5t6U7v8.htmlbook.ZiyEchaiCFu.cOm/article/s5T6u7V8w9.htmlbook.ZiyEchaiCFu.cOm/article/t6U7v8W9x0.htmlbook.ZiyEchaiCFu.cOm/article/u7V8w9X0y1.htmlbook.ZiyEchaiCFu.cOm/article/v8W9x0Y1z2.htmlbook.ZiyEchaiCFu.cOm/article/w9X0y1Z2a3.htmlbook.ZiyEchaiCFu.cOm/article/x0Y1z2A3b4.htmlbbs.ZiyEchaiCFu.cOm/article/A1b2C3d4E5.htmlbbs.ZiyEchaiCFu.cOm/article/B2c3D4e5F6.htmlbbs.ZiyEchaiCFu.cOm/article/C3d4E5f6G7.htmlbbs.ZiyEchaiCFu.cOm/article/D4e5F6g7H8.htmlbbs.ZiyEchaiCFu.cOm/article/E5f6G7h8I9.htmlbbs.ZiyEchaiCFu.cOm/article/F6g7H8i9J0.htmlbbs.ZiyEchaiCFu.cOm/article/G7h8I9j0K1.htmlbbs.ZiyEchaiCFu.cOm/article/H8i9J0k1L2.htmlbbs.ZiyEchaiCFu.cOm/article/I9j0K1l2M3.htmlbbs.ZiyEchaiCFu.cOm/article/J0k1L2m3N4.htmlbbs.ZiyEchaiCFu.cOm/article/K1l2M3n4O5.htmlbbs.ZiyEchaiCFu.cOm/article/L2m3N4o5P6.htmlbbs.ZiyEchaiCFu.cOm/article/M3n4O5p6Q7.htmlbbs.ZiyEchaiCFu.cOm/article/N4o5P6q7R8.htmlbbs.ZiyEchaiCFu.cOm/article/O5p6Q7r8S9.htmlbbs.ZiyEchaiCFu.cOm/article/P6q7R8s9T0.htmlbbs.ZiyEchaiCFu.cOm/blog/Q7r8S9t0U1.htmlbbs.ZiyEchaiCFu.cOm/blog/R8s9T0u1V2.htmlbbs.ZiyEchaiCFu.cOm/blog/S9t0U1v2W3.htmlbbs.ZiyEchaiCFu.cOm/blog/T0u1V2w3X4.htmlbbs.ZiyEchaiCFu.cOm/blog/U1v2W3x4Y5.htmlbbs.ZiyEchaiCFu.cOm/blog/V2w3X4y5Z6.htmlbbs.ZiyEchaiCFu.cOm/blog/W3x4Y5z6A7.htmlbbs.ZiyEchaiCFu.cOm/blog/X4y5Z6a7B8.htmlbbs.ZiyEchaiCFu.cOm/blog/Y5z6A7b8C9.htmlbbs.ZiyEchaiCFu.cOm/blog/Z6a7B8c9D0.htmlbbs.ZiyEchaiCFu.cOm/article/a7B8c9D0e1.htmlbbs.ZiyEchaiCFu.cOm/article/b8C9d0E1f2.htmlbbs.ZiyEchaiCFu.cOm/article/c9D0e1F2g3.htmlbbs.ZiyEchaiCFu.cOm/article/d0E1f2G3h4.htmlbbs.ZiyEchaiCFu.cOm/article/e1F2g3H4i5.htmlbbs.ZiyEchaiCFu.cOm/article/f2G3h4I5j6.htmlbbs.ZiyEchaiCFu.cOm/article/g3H4i5J6k7.htmlbbs.ZiyEchaiCFu.cOm/article/h4I5j6K7l8.htmlbbs.ZiyEchaiCFu.cOm/article/i5J6k7L8m9.htmlbbs.ZiyEchaiCFu.cOm/article/j6K7l8M9n0.htmlbbs.ZiyEchaiCFu.cOm/article/k7L8m9N0o1.htmlbbs.ZiyEchaiCFu.cOm/article/l8M9n0O1p2.htmlbbs.ZiyEchaiCFu.cOm/article/m9N0o1P2q3.htmlbbs.ZiyEchaiCFu.cOm/article/n0O1p2Q3r4.htmlbbs.ZiyEchaiCFu.cOm/article/o1P2q3R4s5.htmlbbs.ZiyEchaiCFu.cOm/article/p2Q3r4S5t6.htmlbbs.ZiyEchaiCFu.cOm/article/q3R4s5T6u7.htmlbbs.ZiyEchaiCFu.cOm/article/r4S5t6U7v8.htmlbbs.ZiyEchaiCFu.cOm/article/s5T6u7V8w9.htmlbbs.ZiyEchaiCFu.cOm/article/t6U7v8W9x0.htmlbbs.ZiyEchaiCFu.cOm/article/u7V8w9X0y1.htmlbbs.ZiyEchaiCFu.cOm/article/v8W9x0Y1z2.htmlbbs.ZiyEchaiCFu.cOm/article/w9X0y1Z2a3.htmlbbs.ZiyEchaiCFu.cOm/article/x0Y1z2A3b4.htmlmp.ZiyEchaiCFu.cOm/article/A2b5C7d1E9.htmlmp.ZiyEchaiCFu.cOm/article/B3c6D8e2F0.htmlmp.ZiyEchaiCFu.cOm/article/C4d7E9f3G1.htmlmp.ZiyEchaiCFu.cOm/article/D5e8F0g4H2.htmlmp.ZiyEchaiCFu.cOm/article/E6f9G1h5I3.htmlmp.ZiyEchaiCFu.cOm/article/F7g0H2i6J4.htmlmp.ZiyEchaiCFu.cOm/article/G8h1I3j7K5.htmlmp.ZiyEchaiCFu.cOm/article/H9i2J4k8L6.htmlmp.ZiyEchaiCFu.cOm/article/I0j3K5l9M7.htmlmp.ZiyEchaiCFu.cOm/article/J1k4L6m0N8.htmlmp.ZiyEchaiCFu.cOm/article/K2l5M7n1O9.htmlmp.ZiyEchaiCFu.cOm/article/L3m6N8o2P0.htmlmp.ZiyEchaiCFu.cOm/article/M4n7O9p3Q1.htmlmp.ZiyEchaiCFu.cOm/article/N5o8P0q4R2.htmlmp.ZiyEchaiCFu.cOm/article/O6p9Q1r5S3.htmlmp.ZiyEchaiCFu.cOm/blog/P7q0R2s6T4.htmlmp.ZiyEchaiCFu.cOm/blog/Q8r1S3t7U5.htmlmp.ZiyEchaiCFu.cOm/blog/R9s2T4u8V6.htmlmp.ZiyEchaiCFu.cOm/blog/S0t3U5v9W7.htmlmp.ZiyEchaiCFu.cOm/blog/T1u4V6w0X8.htmlmp.ZiyEchaiCFu.cOm/blog/U2v5W7x1Y9.htmlmp.ZiyEchaiCFu.cOm/blog/V3w6X8y2Z0.htmlmp.ZiyEchaiCFu.cOm/blog/W4x7Y9z3A1.htmlmp.ZiyEchaiCFu.cOm/blog/X5y8Z0a4B2.htmlmp.ZiyEchaiCFu.cOm/blog/Y6z9A1b5C3.htmlmp.ZiyEchaiCFu.cOm/blog/Z7a0B2c6D4.htmlmp.ZiyEchaiCFu.cOm/article/a8b1C3d7E5.htmlmp.ZiyEchaiCFu.cOm/article/b9c2D4e8F6.htmlmp.ZiyEchaiCFu.cOm/article/c0d3E5f9G7.htmlmp.ZiyEchaiCFu.cOm/article/d1e4F6g0H8.htmlmp.ZiyEchaiCFu.cOm/article/e2f5G7h1I9.htmlmp.ZiyEchaiCFu.cOm/article/f3g6H8i2J0.htmlmp.ZiyEchaiCFu.cOm/article/g4h7I9j3K1.htmlmp.ZiyEchaiCFu.cOm/article/h5i8J0k4L2.htmlmp.ZiyEchaiCFu.cOm/article/i6j9K1l5M3.htmlmp.ZiyEchaiCFu.cOm/article/j7k0L2m6N4.htmlmp.ZiyEchaiCFu.cOm/article/k8l1M3n7O5.htmlmp.ZiyEchaiCFu.cOm/article/l9m2N4o8P6.htmlmp.ZiyEchaiCFu.cOm/article/m0n3O5p9Q7.htmlmp.ZiyEchaiCFu.cOm/article/n1o4P6q0R8.htmlmp.ZiyEchaiCFu.cOm/article/o2p5Q7r1S9.htmlmp.ZiyEchaiCFu.cOm/article/p3q6R8s2T0.htmlmp.ZiyEchaiCFu.cOm/article/q4r7S9t3U1.htmlmp.ZiyEchaiCFu.cOm/article/r5s8T0u4V2.htmlmp.ZiyEchaiCFu.cOm/article/s6t9U1v5W3.htmlmp.ZiyEchaiCFu.cOm/article/t7u0V2w6X4.htmlmp.ZiyEchaiCFu.cOm/article/u8v1W3x7Y5.htmlmp.ZiyEchaiCFu.cOm/article/v9w2X4y8Z6.htmlmp.ZiyEchaiCFu.cOm/article/w0x3Y5z9A7.htmlmp.ZiyEchaiCFu.cOm/article/x1y4Z6a0B8.htmlm.ZiyEchaiCFu.cOm/article/A3b6C8d2E0.htmlm.ZiyEchaiCFu.cOm/article/B4c7D9e3F1.htmlm.ZiyEchaiCFu.cOm/article/C5d8E0f4G2.htmlm.ZiyEchaiCFu.cOm/article/D6e9F1g5H3.htmlm.ZiyEchaiCFu.cOm/article/E7f0G2h6I4.htmlm.ZiyEchaiCFu.cOm/article/F8g1H3i7J5.htmlm.ZiyEchaiCFu.cOm/article/G9h2I4j8K6.htmlm.ZiyEchaiCFu.cOm/article/H0i3J5k9L7.htmlm.ZiyEchaiCFu.cOm/article/I1j4K6l0M8.htmlm.ZiyEchaiCFu.cOm/article/J2k5L7m1N9.htmlm.ZiyEchaiCFu.cOm/article/K3l6M8n2O0.htmlm.ZiyEchaiCFu.cOm/article/L4m7N9o3P1.htmlm.ZiyEchaiCFu.cOm/article/M5n8O0p4Q2.htmlm.ZiyEchaiCFu.cOm/article/N6o9P1q5R3.htmlm.ZiyEchaiCFu.cOm/article/O7p0Q2r6S4.htmlm.ZiyEchaiCFu.cOm/blog/P8q1R3s7T5.htmlm.ZiyEchaiCFu.cOm/blog/Q9r2S4t8U6.htmlm.ZiyEchaiCFu.cOm/blog/R0s3T5u9V7.htmlm.ZiyEchaiCFu.cOm/blog/S1t4U6v0W8.htmlm.ZiyEchaiCFu.cOm/blog/T2u5V7w1X9.htmlm.ZiyEchaiCFu.cOm/blog/U3v6W8x2Y0.htmlm.ZiyEchaiCFu.cOm/blog/V4w7X9y3Z1.htmlm.ZiyEchaiCFu.cOm/blog/W5x8Z0a4A2.htmlm.ZiyEchaiCFu.cOm/blog/X6y9A1b5B3.htmlm.ZiyEchaiCFu.cOm/blog/Y7z0B2c6C4.htmlm.ZiyEchaiCFu.cOm/blog/Z8a1C3d7D5.htmlm.ZiyEchaiCFu.cOm/article/a9b2D4e8E6.htmlm.ZiyEchaiCFu.cOm/article/b0c3E5f9F7.htmlm.ZiyEchaiCFu.cOm/article/c1d4F6g0G8.htmlm.ZiyEchaiCFu.cOm/article/d2e5G7h1H9.htmlm.ZiyEchaiCFu.cOm/article/e3f6H8i2I0.htmlm.ZiyEchaiCFu.cOm/article/f4g7I9j3J1.htmlm.ZiyEchaiCFu.cOm/article/g5h8J0k4K2.htmlm.ZiyEchaiCFu.cOm/article/h6i9K1l5L3.htmlm.ZiyEchaiCFu.cOm/article/i7j0L2m6M4.htmlm.ZiyEchaiCFu.cOm/article/j8k1M3n7N5.htmlm.ZiyEchaiCFu.cOm/article/k9l2N4o8O6.htmlm.ZiyEchaiCFu.cOm/article/l0m3O5p9P7.htmlm.ZiyEchaiCFu.cOm/article/m1n4P6q0Q8.htmlm.ZiyEchaiCFu.cOm/article/n2o5Q7r1R9.htmlm.ZiyEchaiCFu.cOm/article/o3p6R8s2S0.htmlm.ZiyEchaiCFu.cOm/article/p4q7S9t3T1.htmlm.ZiyEchaiCFu.cOm/article/q5r8T0u4U2.htmlm.ZiyEchaiCFu.cOm/article/r6s9U1v5V3.htmlm.ZiyEchaiCFu.cOm/article/s7t0V2w6W4.htmlm.ZiyEchaiCFu.cOm/article/t8u1W3x7X5.htmlm.ZiyEchaiCFu.cOm/article/u9v2X4y8Y6.htmlm.ZiyEchaiCFu.cOm/article/v0w3Y5z9Z7.htmlm.ZiyEchaiCFu.cOm/article/w1x4Z6a0A8.htmlm.ZiyEchaiCFu.cOm/article/x2y5A7b1B9.html