私有方法在pytest中根本不需要Mock，Python无真正私有机制，pytest-mock不区分公私；常见错误是mock未被外部调用的内部实现，测试应聚焦公共接口；若确需mock，优先用patch.object操作实例，注意双下划线名称改写规则，并避免破坏封装设计。
私有方法在pytest中根本不需要Mock
Python没有真正的私有机制，所谓“私有”只是命名约定（_name）或弱封装（__name触发名称改写）。pytest + unittest.mock 本身不区分公私，只要能访问到对象，就能打桩。
常见错误是试图用 patch 去 mock 一个根本没被外部调用的私有方法——它通常只是内部实现细节，测试应聚焦在公共接口行为上。
- 如果私有方法逻辑复杂、副作用明显（比如发HTTP请求、读文件），建议把它提取为独立函数或服务类，再对那个可测试单元做mock
- 若坚持要mock
_helper()，直接 patch 实例方法即可：type(instance)._helper = Mock(return_value=42) - 对双下划线方法如
__process()，实际属性名变成_ClassName__process，patch时必须用改写后的名字
用patch.object安全地替换实例私有方法
比全局 patch 更精准，避免影响其他测试。关键是传入目标实例和改写后的方法名（对双下划线方法）。
def test_with_private_method_mock():
obj = MyClass()
# 对 _internal_calc 直接 patch
with patch.object(obj, '_internal_calc', return_value=99):
assert obj.public_api() == 99
<pre class="brush:php;toolbar:false;"># 对 __validate，需用名称改写后的形式
with patch.object(obj, '_MyClass__validate', return_value=True):
assert obj.process() is True
- 不要 patch 类定义里的
__validate，而要 patch 实例上的_MyClass__validate - 使用
patch.object而非patch，避免误伤同名方法在其他实例上的行为 - 若私有方法被
@staticmethod或@classmethod修饰，patch位置要相应调整到类对象上
Mock私有属性时别碰__dict__硬编码
私有属性如 self._cache 或 self.__data 可直接赋值覆盖，无需动 __dict__。强行操作 __dict__ 容易因名称改写失效，且破坏可读性。
- 安全做法：
obj._cache = {"key": "fake"}（单下划线）或obj._MyClass__data = b"raw"（双下划线） - 错误做法：
obj.__dict__["_MyClass__data"] = ...—— 依赖内部结构，PyPy或未来CPython版本可能变化 - 如果私有属性是只读的（比如通过
@property控制），应 mock 对应的 property 方法，而不是底层字段
为什么多数情况下不该Mock私有成员
Mock私有方法/属性往往暴露了设计问题：要么职责过重，要么边界不清。pytest 的核心价值在于验证**可观测行为**，不是校验内部怎么写的。
- 当测试被迫依赖私有实现，意味着重构时测试会频繁失败，违背“测试应稳定反映需求”的原则
- 真正需要隔离的是外部依赖（数据库、网络、时间），不是同类里的另一个方法
- 如果发现必须 mock 私有方法才能让测试跑通，先问：这个方法是否该拆成独立可测试单元？它的输入输出能否显式化？
名称改写、patch路径、实例绑定方式——这些细节容易错，但更关键的是：先确认你真的需要它。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
