同名函数调用哪个？搞懂作用域和调用优先级（实战经验分享）

写代码时经常会遇到这种情况：两个函数名字一模一样，一个在全局里，一个在某个模块或对象里，调的时候到底走哪一个？尤其在做内网穿透工具开发时，比如用 Python 写个本地服务转发脚本，引入多个库之后，这种冲突更容易冒出来。

从一段简单的 Python 例子说起

假设你写了个小脚本，用来启动本地 HTTP 服务做内网穿透调试：

def start_server():
    print("启动了自定义服务")

import http.server

def serve():
    start_server()  # 这里调的是谁？

serve()

看起来没啥问题。但如果某个第三方库也定义了一个 start_server，并且你又把它 import 进来了，情况就变了。这时候你得看函数定义的位置和作用域层级。

作用域决定一切

Python 遵循 LEGB 规则：Local、Enclosed、Global、Built-in。也就是说，解释器会先在局部找，再往外层嵌套作用域找，然后是全局，最后是内置函数。

比如你在类里定义了一个和外面一样的函数名：

def handle_request():
    print("外部处理逻辑")

class ProxyHandler:
    def handle_request(self):
        print("内部方法被调用")
    
    def process(self):
        self.handle_request()  # 明确调用自己的方法

# 外部调用
handle_request()  # 调用的是全局那个

这时候不会冲突，因为一个是实例方法，一个是全局函数，调用方式不同。但如果你在全局作用域重新定义一次同名函数，后面的就会覆盖前面的。

模块导入时的命名冲突更常见

比如你用了两个包，都提供了 connect() 函数：

from ngrok import connect
from localtunnel import connect  # 同名！后者覆盖前者

这种情况下，第二个 connect 会把第一个顶掉。运行时你以为调的是 ngrok 的，其实走的是 localtunnel 的逻辑，结果本地服务连不上，排查半天才发现是函数被悄悄替换了。

怎么避免踩坑？

最简单的办法就是别让名字打架。可以用 as 给函数或模块改个别名：

from ngrok import connect as ngrok_connect
from localtunnel import connect as lt_connect

# 调用时清清楚楚
ngrok_connect(port=8000)
lt_connect(port=3000)

这样既保留了功能，又避免了混淆。尤其是在写自动化脚本或者封装工具链的时候，这种命名管理特别重要。

另外，在调试内网穿透程序时，如果发现某个回调没触发，先别急着查网络配置，回头看看是不是函数名重复导致实际调的不是你以为的那个。

编程不像聊天，不能靠语境猜意思。机器只认名字和作用域。名字一样，位置不同，行为就可能完全不同。