在Python中，单下划线（_）和双下划线（__）开头的命名，核心区别在于：单下划线是一种“约定”，而双下划线是一种“机制”。

前者是给程序员看的提示，后者是Python解释器会实际执行的规则。

单下划线开头 _var：一种“内部使用”的约定

这是一种广泛遵守的编码规范，由PEP 8定义。它主要起提示作用，解释器本身不会强制执行任何访问限制。

• 含义：告诉其他开发者，这个属性或方法是“内部的”或“非公开的”（protected），属于实现细节，不应在外部直接使用。这有助于保持代码的稳定性和可维护性。
• 实际效果：
  • 访问上不受限：你仍然可以访问它，但这样做被认为是不好的编程习惯。
  • 导入时被忽略：当你使用 from module import * 时，以单下划线开头的名称不会被导入。
• 使用场景：
  • 类的“保护”成员。
  • 模块内部的函数或变量。
  • 作为循环中的临时变量或占位符。

双下划线开头 __var：一种“名称修饰”的机制

这并非用于实现“私有”属性，而是Python解释器执行的一种“名称修饰”（Name Mangling）技术。

• 含义：主要用于防止在继承时子类意外覆盖（override）父类的属性或方法。它不是为了防止外部访问，而是为了避免在复杂的继承体系中发生命名冲突。
• 机制与效果：
  • 名称被改写：在类定义内部，所有以双下划线开头的名称，都会被Python解释器自动重命名，格式为 _ClassName__var。
  • 访问需通过修饰名：因此，你不能直接通过 obj.__var 访问，但可以通过 obj._ClassName__var 访问到。这也证明了它并非真正的私有。
• 使用场景：当你明确知道你的类会被广泛继承，并且有一些内部属性绝对不应该被子类覆盖时，才考虑使用。

特殊情况：双下划线开头和结尾 __var__

这是Python官方预留的“特殊方法”或“魔法方法”命名模式。例如__init__（构造函数）、__str__等。请绝对不要在自己的代码中创造这种名字，它仅供Python内部使用。

总结对比

最佳实践建议

Python的哲学是“我们大家都是成年人”。它相信程序员会自觉遵守约定，而不是通过强制的语法来限制。

1. 默认使用单下划线：对于大多数“非公共”的属性和方法，使用单下划线 _var 是更普遍和推荐的做法。
2. 按需使用双下划线：仅在你有明确需求，必须防止子类覆盖某些关键内部属性时，才考虑使用双下划线 __var。

理解并遵循这些约定，是写出地道、专业且易于维护的Python代码的重要一步。