Python如何在运行前检测类方法被实例属性覆盖的问题

完全可以通过静态类型检查工具在代码运行前发现这类问题，目前主流的Python类型检查工具（mypy、pyright等）都原生支持这类冲突检测。

问题本质 #

你遇到的报错是Python的属性查找规则导致的：实例属性的优先级高于类属性/方法，你在__init__中给self.records赋值为None后，实例的records属性会覆盖类层面定义的同名records方法，调用时拿到的是None而非可调用的方法对象，就会抛出'NoneType' object is not callable错误。

检测方法 #

1. 使用mypy检测 #

mypy默认开启的no-redef规则会直接识别到这类重定义冲突，你只需要给代码补全类型注解后运行mypy检查，就会得到如下报错：

error: Name "records" already defined on line [类方法定义的行号]  [no-redef]

如果默认没触发，可以在mypy配置文件（mypy.ini）中手动开启规则：

[mypy]
enable_error_code = no-redef
strict = true # 开启严格模式会覆盖更多潜在问题

2. 使用pyright/Pylance检测 #

VSCode常用的Pylance插件底层基于pyright，默认就会在代码编辑阶段直接标红冲突位置，报错提示为：

Declaration "records" is obscured by a declaration in the same class

不需要额外运行命令，写代码时就能实时收到提示。

最佳规避方案 #

除了依赖类型检查工具，还可以通过命名规范从根源避免这类冲突：内部存储用的实例属性统一加下划线前缀，比如把self.records = None改成self._records = None，和公开方法名区分开即可。

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