Pylint对函数默认参数报redefined-outer-name警告的原因

def print_name(your_name = "Anonymous Andy"):
    print("Hello, " + your_name)

def your_name():
    # This function has same name as variable in above function
    return None

print_name() # Prints "Hello, Anonymous Andy"
print_name("World") # Prints "Hello, World"

以上为Python学习阶段编写的测试代码，非生产环境使用。使用Pylint（2.14.0版本）对代码做静态检查时，抛出如下警告：

1:15: W0621: Redefining name 'your_name' from outer scope (line 4) (redefined-outer-name)

问题解答 #

1. 你对告警字面含义的理解基本正确，但需要注意：这个告警里说的“重定义”不是指你修改了外层作用域的your_name对象，而是指你在内层作用域声明了同名标识符，对外层的同名标识符造成了遮蔽。
2. 你认为Pylint判断存在偏差的认知是错误的，Pylint的告警触发逻辑符合规则设计目标。
   你提到的your_name是print_name函数内的局部参数变量，这个判断本身没错，但这恰恰是触发告警的原因——这个局部参数名和全局作用域的函数名your_name重名了，会导致全局的your_name在print_name函数内部无法被直接引用。
3. 你确实遗漏了Python作用域规则和Pylint该检查项的设计逻辑，这里不存在Pylint误报的问题：
   • 首先Python采用静态词法作用域，只要在函数内部（包含参数列表位置）出现了标识符绑定行为（参数定义、赋值、函数/类定义、导入都算绑定），那么该函数内所有对这个标识符的引用都会优先指向局部绑定，无论外层同名标识符的定义写在函数前面还是后面。
   • Pylint做静态扫描时会先收集全文件所有作用域的标识符绑定关系，不会严格按照代码从上到下的书写顺序判断重名。redefined-outer-name规则的核心检测目标是**名称遮蔽（Name Shadowing）**风险，而非“先定义外层名字、再在内层修改外层名字”的行为。这个规则的设计初衷是避免开发者本来想引用外层同名对象，却因为局部有同名绑定意外引用了局部对象，引发难以排查的逻辑bug。
   • 你的测试代码运行不会报错，只是因为你在print_name内部本来就没有调用全局your_name()函数的需求，重名遮蔽没有实际影响，但这种命名方式确实存在潜在风险。如果要消除告警，只需要修改局部参数名或者全局函数名避免重名即可，也可以通过行内注释# pylint: disable=redefined-outer-name针对性抑制该告警。

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