为何Python调用C++定义的不一致函数名仍能正常执行？

核心原因拆解 #

你碰到的“函数名不匹配却能正常执行”的情况，跑不出以下几种场景：

1. Pybind11模块重载了__call__方法（对应mt_load()调用）

如果mt_load.cpp里（可能你没看到完整实现）通过pybind11给模块本身绑定了__call__方法，就能直接用mt_load(...)的形式调用模块，本质是触发这个重载方法。

比如cpp里可能有这段代码：

// 给模块添加__call__逻辑，默认调用load_int64
m.def("__call__", [](std::string file, int64_t size) {
    return load_int64(file, size);
}, "Default to load int64 data");

这种情况下，Python里调用mt_load(path, size)就会执行这个lambda，间接调用到load_int64，刚好匹配你看到的get_rowptr_mt逻辑。

2. 存在未展示的别名定义（对应mt_load_float()调用）

mt_load_float肯定是load_float32的别名，只是你没找到定义的地方。常见的写法：

• 在wrapper.py里：

  mt_load_float = mt_load.load_float32
  

• 在utils.py里：

  mt_load_float = load_float32
  

因为data.py用from lib.utils import *导入了所有名字，只要utils或wrapper里有这个别名，就能直接调用。

3. 实际运行代码和你查看的版本不一致

你看的可能是项目的旧版本代码，实际运行的代码已经改了pybind11的绑定名：
比如cpp里的绑定被改成了：

PYBIND11_MODULE(mt_load, m) {
    m.def("mt_load", &load_int64, "multi-threaded load (int64)");
    m.def("mt_load_float", &load_float32, "multi-threaded load (float32)");
}

这种情况名称完全匹配，自然能正常跑。

4. 导入路径混淆（概率低）

如果data.py所在目录或父目录有其他同名模块/文件，可能导致导入的不是你预期的对象，但你说确认无其他转换逻辑，这种情况可能性很小。

验证步骤 #

• 直接在项目环境里跑这段代码，看mt_load和mt_load_float的实际指向：

  from lib.utils import *
  print(type(mt_load))
  print(getattr(mt_load, "__name__", "No name attr"))
  print(type(mt_load_float))
  print(getattr(mt_load_float, "__name__", "No name attr"))
  

  如果mt_load是函数，说明有__call__绑定或别名；如果是模块，说明模块本身实现了__call__。
• 检查wrapper.py和utils.py的完整代码，找别名定义。
• 看项目Git提交记录，确认是否有绑定名称的修改。

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