Python：如何重命名已公开类实例变量并兼容旧代码？

你可以通过Python的@property和对应的setter装饰器实现需求，既完成变量重命名，又保留旧的nr读写方式，完整示例如下：

class Foo:
    def __init__(self):
        self.val = 0  # 新的实例变量名

    @property
    def nr(self):
        # 读取.nr时返回.val的值
        return self.val

    @nr.setter
    def nr(self, value):
        # 给.nr赋值时同步修改.val
        self.val = value

验证效果 #

运行以下代码测试读写兼容性：

f1 = Foo()
print(f1.nr)  # 输出0，实际读取的是val
f1.nr = 10
print(f1.val)  # 输出10，val被成功修改
print(f1.nr)  # 输出10，nr返回最新的val值

可选：添加废弃警告（引导用户迁移） #

如果希望逐步引导用户切换到新变量名val，可以在访问nr时添加废弃警告，不影响现有代码运行的同时提醒用户更新：

import warnings

class Foo:
    def __init__(self):
        self.val = 0

    @property
    def nr(self):
        warnings.warn("`nr`已废弃，请使用`val`代替", DeprecationWarning, stacklevel=2)
        return self.val

    @nr.setter
    def nr(self, value):
        warnings.warn("`nr`已废弃，请使用`val`代替", DeprecationWarning, stacklevel=2)
        self.val = value

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