跨模块场景下，如何通过类方法修改另一个类的指定实例？

嘿，这个坑我以前踩过好几次——本质上是你在类方法里隐式引用了模块级的全局变量，而Python的作用域规则是「定义时绑定」，不是「调用时绑定」。

具体为啥跨模块就报错？ #

举个你代码的简化版例子就懂了：
假设你的模块1（类定义的地方）是这样的：

# module1.py
class Foo:
    def test(self):
        print("Foo works")

class Bar:
    def act_on_foo(self):
        foo.test()  # 这里直接写了"foo"，它找的是module1里的foo

# 模块1里创建了foo实例，所以在module1里调用Bar().act_on_foo()完全没问题
foo = Foo()

然后你在模块2里这么用：

# module2.py
from module1 import Foo, Bar

# 这里的foo是module2的全局变量，和module1里的foo根本不是同一个东西！
foo = Foo()
Bar().act_on_foo()  # 报错：NameError: name 'foo' is not defined

当Bar.act_on_foo被定义的时候，Python就已经把foo的查找路径固定死了——它只会去module1的全局作用域找这个变量，而module2里的foo不在这个作用域里，自然找不到。哪怕两个变量名字一模一样，也完全是两个独立的东西。

怎么解决？ #

最靠谱的方案是显式传递目标实例，彻底摆脱对全局变量的依赖：

方案1：把实例作为方法参数传入（最推荐）

修改Bar的类方法，让它接收Foo实例作为参数：

# module1.py
class Bar:
    def act_on_foo(self, foo_instance):
        foo_instance.test()

然后在模块2里调用时直接传你创建的实例：

# module2.py
foo = Foo()
Bar().act_on_foo(foo)

方案2：把实例绑定为Bar的实例属性

如果Bar的实例需要长期和某个Foo实例关联，可以在初始化时传入：

# module1.py
class Bar:
    def __init__(self, foo_instance):
        self.target_foo = foo_instance
    
    def act_on_foo(self):
        self.target_foo.test()

模块2里的用法：

foo = Foo()
bar = Bar(foo)
bar.act_on_foo()

方案3：设置Bar的类属性（适合全局共享的实例）

如果你需要所有Bar实例都作用于同一个Foo实例，可以给Bar加个类属性来存储：

# module1.py
class Bar:
    global_foo = None
    
    @classmethod
    def set_global_foo(cls, foo_instance):
        cls.global_foo = foo_instance
    
    @classmethod
    def act_on_foo(cls):
        if cls.global_foo:
            cls.global_foo.test()

模块2里先设置再调用：

foo = Foo()
Bar.set_global_foo(foo)
Bar.act_on_foo()

总结 #

永远记住：Python的函数（包括类方法）在定义的时候就确定了变量的查找范围，不要依赖跨模块的全局变量隐式引用——这种写法耦合性极强，一换环境就崩。显式传递实例才是Pythonic的解决方式。

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