Python中如何向用户隐藏方法但允许其他类调用

这确实是模块开发里挺常见的场景——想让模块内部的其他类能调用某个方法，但要明确引导外部用户别碰它。你提到的单下划线其实比你想的更适配这个需求，我来给你拆解几个可行的方案：

• 单下划线约定+清晰文档提示（最推荐）
  Python里的单下划线前缀（比如_internal_method）本质是一种社区约定，而非强制的访问限制。外部用户完全可以调用它，但IDE、静态检查工具（比如PyCharm、mypy）都会给用户标黄/标红提示，明确告知这是内部API，不建议使用。同时，你可以在方法的文档字符串里进一步强化说明：

  class YourClass:
      def _internal_method(self):
          """
          内部方法，仅供模块内其他类调用，外部用户请勿依赖此方法。
          该方法的实现可能在未来版本中修改或移除。
          """
          # 方法核心逻辑
  

  这种方式完全允许模块内的其他类正常调用obj._internal_method()，又能有效引导用户避开它，是Python社区最常用的做法，像requests、pandas这类知名库都是这么处理内部方法的。

• 用类型检查工具强化禁用提示
  如果想让静态检查更严格，可以借助mypy-extensions的@internal装饰器。安装后这样写：

  from mypy_extensions import internal
  
  class YourClass:
      @internal
      def _internal_method(self):
          # 方法逻辑
  

  当外部用户尝试调用这个方法时，mypy会直接抛出错误提示，进一步强化“请勿使用”的信号，但运行时依然可以正常调用，完全不影响内部类的使用。

• 内部子模块隔离（进阶方案）
  要是你想做更彻底的逻辑隔离，可以把这类共享的内部方法放到模块的“内部子模块”里，比如your_package/_internal.py，然后在业务类中导入使用：

  # your_package/_internal.py
  def shared_internal_logic(obj):
      # 供内部类共享的逻辑实现
  
  # your_package/main.py
  from ._internal import shared_internal_logic
  
  class ClassA:
      def some_method(self):
          shared_internal_logic(self)
  
  class ClassB:
      def another_method(self):
          shared_internal_logic(self)
  

  这种方式下，外部用户如果没特意留意_internal模块，很难发现这些方法，而模块内的类可以毫无障碍地使用。虽然Python没有真正的“私有模块”，用户仍能强行导入，但已经足够起到引导和隐藏的作用。

最后纠正一个小误解：Python里的单下划线并不是Java那种严格的protected（仅子类可用），它的核心作用是标记“这是内部实现，外部依赖需自行承担变更风险”，完全符合你“允许其他类调用，同时提示用户别用”的需求。

内容的提问来源于stack exchange，提问作者Marco Aguiar