Python 3导入与内置模块同名的自定义模块问题求助

问题1：仅导入目录下的自定义math.py #

你遇到的问题本质是Python的模块查找顺序导致的——当你写import math时，Python会优先加载内置的math模块，而非你目录下的自定义文件。这里有两种无需修改模块名的靠谱解法：

方法1：用importlib手动加载自定义模块

这种方式能精准指定加载你本地的math.py，完全绕过内置模块的优先级：

# main.py
import importlib.util
import os

# 加载当前目录下的math.py文件
spec = importlib.util.spec_from_file_location("custom_math", os.path.join(os.path.dirname(__file__), "math.py"))
custom_math = importlib.util.module_from_spec(spec)
spec.loader.exec_module(custom_math)

def main():
    print(custom_math.f(3))  # 输出27

if __name__ == "__main__":
    main()

我们给自定义模块起了custom_math的别名，既避免和内置模块冲突，又能明确区分来源。

方法2：将目录作为Python包运行

先在folder目录下创建空的__init__.py文件（让Python识别它为一个包），然后在folder的上级目录用模块方式启动main.py：

python -m folder.main

此时main.py可以用相对导入：

# main.py
from . import math as custom_math  # 用别名区分内置模块

def main():
    print(custom_math.f(3))

if __name__ == "__main__":
    main()

注意这种方法不能直接用python main.py启动，必须通过-m参数以包模块的方式运行。

问题2：同时使用自定义math.f(x)和内置math.acos(x) #

核心思路是给其中一个模块起别名，彻底避免命名冲突。结合上面的方法，提供两种实用方案：

方案1：内置模块取别名 + importlib加载自定义模块

# main.py
import math as builtin_math  # 内置模块重命名
import importlib.util
import os

# 加载自定义math.py
spec = importlib.util.spec_from_file_location("custom_math", os.path.join(os.path.dirname(__file__), "math.py"))
custom_math = importlib.util.module_from_spec(spec)
spec.loader.exec_module(custom_math)

def main():
    print(custom_math.f(3))  # 自定义函数：输出27
    print(builtin_math.acos(-1))  # 内置函数：输出3.141592653589793

if __name__ == "__main__":
    main()

方案2：包模式下同时导入两个模块

同样先创建__init__.py并以-m方式启动，然后：

# main.py
import math as builtin_math  # 内置模块取别名
from . import math as custom_math

def main():
    print(custom_math.f(3))
    print(builtin_math.acos(-1))

if __name__ == "__main__":
    main()

额外提示 #

因为你提到这是十年前的老代码、修改模块名成本极高，上面的所有方法都不需要改动math.py的文件名，只需要调整main.py的导入逻辑，完美适配你的遗留代码场景。

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