本文介绍如何使用 unittest.mock.patch.object 精准地仅 mock 类的某个特定属性（如 some_attribute），而保留其余属性（如 another_attribute）的原始值和行为，避免全局替换类实例导致的副作用。
本文介绍如何使用 `unittest.mock.patch.object` 精准地仅 mock 类的某个特定属性（如 `some_attribute`），而保留其余属性（如 `another_attribute`）的原始值和行为，避免全局替换类实例导致的副作用。
在单元测试中，我们常需要“局部打桩”——即只修改类或实例的某一个属性，同时确保其他所有行为（包括其他属性、方法、初始化逻辑等）完全保持原样。但若直接 @patch("some_module.Config")，会将整个类替换为 MagicMock，导致未显式设置的属性（如 another_attribute）也变成 MagicMock 对象，失去原始语义。
正确做法是：优先将目标属性设计为类属性（class attribute），再使用 patch.object 直接替换该类属性的值。 这种方式轻量、精准，且无需修改被测逻辑的调用方式（仍通过 Config.xxx 访问）。
✅ 推荐重构方案（推荐用于新代码或可调整结构的场景）：
# config.py
class Config:
some_attribute = "some value" # ← 改为类属性（非实例属性）
another_attribute = 123# some_module.py
from config import Config
def method_that_uses_config():
print(Config.another_attribute) # 输出 123（原始值，未被干扰）
return Config.some_attribute # 返回被 mock 后的值# test_some_module.py
import unittest
from unittest.mock import patch
from some_module import method_that_uses_config
class TestConfig(unittest.TestCase):
@patch.object('some_module.Config', 'some_attribute', 'mocked value')
def test_method_that_uses_config(self):
result = method_that_uses_config()
self.assertEqual(result, 'mocked value')
# ✅ Config.another_attribute 仍为 123，未被影响⚠️ 注意事项：
- patch.object(target, attribute, new_value) 作用于 类层级，因此要求目标属性是类属性（self.xxx 在 __init__ 中赋值属于实例属性，不适用此法）；
- 若必须保留实例属性（即 some_attribute 必须在 __init__ 中动态设置），则需改用 wraps + side_effect 或 spec_set=True 配合手动设置，但复杂度显著上升；
- patch.object 的 target 参数应传入运行时实际导入的模块路径（如 'some_module.Config'），而非原始定义模块（'config.Config'），否则 patch 失效；
- 使用 @patch.object 修饰器时，mock 对象参数（如 mock_config）不会被传入测试方法（因为 patch 的是属性，不是类本身），因此签名中无需声明该参数。
? 总结：
当目标是“仅替换一个属性值，其余一切照旧”，最简洁可靠的方案是：
① 将待 mock 属性改为类属性；
② 使用 @patch.object(module.Class, 'attr_name', new_value) 进行静态打桩。
这既符合单一职责原则，又规避了 MagicMock 对未声明属性的自动代理行为，让测试更稳定、语义更清晰。
