如何将作为模块使用的Python文件合并到主脚本文件中？

阿华AIGC实验室

2026-4-14

嘿，我完全懂你的需求——不想用暴力复制粘贴函数的笨办法，又要把分散在子目录里的模块都塞进单个脚本，还得保持原来的导入逻辑能正常工作对吧？针对这种情况，有几个比brute-force更优雅的方案，我给你详细说说：

方法一：手动构建模块层级（适合少量模块场景）

你可以在主脚本foo里手动模拟出utils和utils.bar的模块结构，把bar.py的内容嵌入到对应的模块对象中，这样原来的导入语句完全不用改。具体步骤如下：

先删掉原来的sys.path.append和from utils.bar import...那几行代码
在主脚本开头添加模块构建的代码：

import types
import sys

# 创建utils模块并注册到系统模块列表
utils = types.ModuleType('utils')
sys.modules['utils'] = utils

# 创建utils.bar子模块
bar = types.ModuleType('utils.bar')
# 把bar.py里的函数/变量直接定义到这个模块里
def func1(x):
    # 这里替换成bar.py中func1的实际代码
    return x * 2

def func2(y):
    # 替换成bar.py中func2的实际代码
    return y + 5

def func3(z):
    # 替换成bar.py中func3的实际代码
    return z ** 3

# 将函数挂载到bar模块对象上
bar.func1 = func1
bar.func2 = func2
bar.func3 = func3

# 把bar模块挂到utils模块下，并注册到系统
utils.bar = bar
sys.modules['utils.bar'] = bar

完成后，原来脚本里from utils.bar import func1, func2或者utils.bar.func3()这类调用都能和之前一样正常运行，完全不需要外部的utils/目录了。

方法二：字符串嵌入模块内容（适合代码量较多的模块）

如果bar.py里的代码比较多，手动逐个定义函数太麻烦，你可以把bar.py的完整内容作为字符串，用exec加载到模块对象中：

import types
import sys

# 把bar.py的完整代码复制到这个字符串里，注意保持原有的缩进
bar_module_content = '''
def func1(x):
    return x * 2

def func2(y):
    return y + 5

def func3(z):
    return z ** 3

# 这里可以添加bar.py里的其他代码，比如类、变量等
'''

# 创建并注册utils模块
utils = types.ModuleType('utils')
sys.modules['utils'] = utils

# 创建utils.bar模块并加载内容
bar = types.ModuleType('utils.bar')
exec(bar_module_content, bar.__dict__)
utils.bar = bar
sys.modules['utils.bar'] = bar

这种方式相当于把bar.py的代码“内嵌”到主脚本里，同时保持了模块的结构，原来的导入逻辑完全兼容。