pytest中不能直接打桩私有方法，需打桩其被调用处；正确方式是patch导入位置而非定义位置，或用patch.object操作实例，且应考虑重构将私有逻辑提取为可测单元。
pytest里不能直接打桩私有方法，得打桩它被调用的地方
Python没有真正的私有方法，_method 只是约定，但 pytest 的 patch 不能直接对实例方法（尤其是带 self 的）做 inline patch。你真正要 mock 的，是「谁在调用它」——比如某个公有方法内部调用了 _private_helper，那就该在测试中 patch 这个公有方法所在类的命名空间里的 _private_helper。
常见错误是写成 @patch('mymodule.MyClass._private_helper') 却没生效：因为实际调用发生在实例上，而 patch 目标必须和导入/引用路径一致。
- ✅ 正确做法：patch 所在模块中「被导入并使用」的位置，比如
test_module.py里写了from mymodule import MyClass，又在测试函数里创建了obj = MyClass()，那就要 patch'test_module.MyClass._private_helper' - ❌ 错误做法：patch
'mymodule.MyClass._private_helper'（除非你在 test 文件里直接 from mymodule import MyClass 并在局部作用域调用） - ⚠️ 注意：如果私有方法是
@staticmethod或@classmethod，patch 方式不变，但要确保装饰器没干扰绑定逻辑
用 patch.object 针对实例打桩更稳妥
当私有方法只在某个具体实例上调用，且你不想污染模块级 patch 路径时，patch.object 是更可控的选择。它绕过了路径匹配问题，直接操作对象属性。
示例场景：你有个 Processor 类，其 run() 方法调用了 self._fetch_data()，你想让 _fetch_data 返回模拟数据：
立即学习“Python免费学习笔记（深入）”；
def test_run_calls_mocked_private_method():
proc = Processor()
# 替换实例上的私有方法为 MagicMock
mock_fetch = Mock(return_value=["a", "b"])
patch.object(proc, "_fetch_data", mock_fetch)
<pre class="brush:php;toolbar:false;">result = proc.run()
mock_fetch.assert_called_once()
assert result == ["a", "b"]
- ✅
patch.object(obj, "_method", ...)直接修改实例字典，不依赖导入路径 - ⚠️ 如果私有方法被
__getattribute__或描述符覆盖，patch.object 可能失效，需检查是否用了自定义属性访问逻辑 - ? 记得在测试末尾调用
mock_fetch.stop()（若手动 start），或用上下文管理器更安全
私有方法逻辑太重？说明设计可能需要重构
频繁想打桩私有方法，往往暴露了两个现实问题：一是这个“私有”方法承担了可独立验证的职责；二是当前类职责过重，把本该抽离的逻辑塞进了实现细节里。
- ? 真实建议：把
_process_payload提成独立函数或新类（如PayloadProcessor），然后在原类中注入或组合它——这样测试时直接 mock 新模块即可，无需碰私有命名 - ? pytest 本身不鼓励测试私有实现，只保证公有接口行为。如果你发现不打桩私有方法就写不出单元测试，大概率是封装边界模糊了
- ? 补充技巧：加
# pragma: no cover注释在私有方法上，配合覆盖率工具排除它们，避免因“无法覆盖”而降低报告可信度
patch 的 scope 和自动 cleanup 容易漏掉
pytest 中用 @patch 装饰器默认是函数级 scope，但很多人忘了：如果在 fixture 里用 patch.start() 却没配 addfinalizer，mock 就不会自动还原，可能污染后续测试。
- ✅ 推荐用 fixture + context manager：
@pytest.fixture
def patched_private():
with patch("myapp.service.Service._do_work") as mock_do:
mock_do.return_value = 42
yield mock_do
<p>def test_something(patched_private):
assert service.execute() == 42
patched_private.assert_called_once()
- ⚠️ 如果用
patch(...).start()，必须显式addfinalizer(patch.stop)，否则 teardown 阶段不恢复原始方法 - ? 检查是否生效的小技巧：在测试中打印
obj._private_method，看它是原始函数还是Mock实例
私有方法打桩不是不行，而是每一步都卡在 Python 的绑定机制和 patch 的作用域规则上。路径写错、scope 没关、mock 没还原——这三个点，比语法本身更容易让测试跑飞。
