代码功底之——方法命名

在Python中,方法名前加下划线是一种命名约定,具有特定的含义:

单下划线前缀(如 _save_checkpoint)

表示这是一个 内部方法 (也称为"保护方法"),主要用于以下目的:

  1. 代码组织 :明确标识这个方法是类内部使用的,不建议外部直接调用
  2. 封装性 :强调方法的使用范围,提高代码的可维护性
  3. 命名空间隔离 :避免与外部代码发生命名冲突

为什么在这个代码中使用

在 DataMigration 类中, _save_checkpoint 、 _load_checkpoint 和 _clean_checkpoint 方法都使用了单下划线前缀,因为:

  • 这些方法只在类内部被其他方法调用(如 run 和 bulk_import )
  • 它们不应该被类的外部使用者直接调用
  • 这样的命名约定使代码结构更清晰,明确了方法的职责和使用范围

其他下划线命名约定

  • 双下划线前缀 (如 __method ):触发名称修饰(name mangling),更严格的私有方法
  • 双下划线前后缀 (如 method ):特殊方法(魔术方法),具有特殊用途
posted @ 2026-03-25 15:23  亦痕  阅读(13)  评论(0)    收藏  举报
//点击特效 //为右下角推荐推荐区域添加关注按钮 // 生成目录索引列表 //返回顶部