如何将关联Python文件合并为单文件且保留原有导入逻辑不改动源码

完全可以实现，核心思路是在合并文件的开头先手动构造原有目录对应的模块命名空间，注册到Python的导入系统中，再按依赖顺序拼接业务代码，全程不需要修改原有业务的导入、调用逻辑。

具体实现方案 #

方案1：手动构造虚拟模块（最稳妥，无额外依赖） #

操作步骤如下：

1. 在合并文件的最开头，先构造和原有目录结构完全一致的虚拟模块，并注册到sys.modules中，示例代码如下：

import sys
from types import ModuleType

# 构造根utils模块并注册到导入系统
utils = ModuleType("utils")
sys.modules["utils"] = utils

# 构造utils.file_one子模块
utils.file_one = ModuleType("utils.file_one")
sys.modules["utils.file_one"] = utils.file_one
# 以下直接粘贴原utils/file_one.py的所有业务代码
def function_one(val):
    # 原有逻辑完全不动
    print(f"input val: {val}")
# 把file_one里的顶层对象挂载到对应子模块
utils.file_one.function_one = function_one

# 构造utils.file_two子模块，逻辑同上
utils.file_two = ModuleType("utils.file_two")
sys.modules["utils.file_two"] = utils.file_two
# 粘贴原utils/file_two.py的所有业务代码
def function_two():
    return "result"
utils.file_two.function_two = function_two

# 如果原utils/__init__.py有自定义逻辑，把对应代码粘贴到此处执行即可

2. 把目标same_step_x.py的所有代码原样粘贴到上述虚拟模块构造代码的后面。

此时原有from utils.file_one import function_one这类导入语句执行时，会优先从sys.modules中读取已经注册好的虚拟模块对象，和原目录结构下的执行逻辑完全一致，不需要修改任何业务代码。

方案2：脚本自动化生成合并文件（适合step数量多的场景） #

你可以写一个简单的打包脚本，自动完成上述拼接流程：

• 遍历utils目录下的所有.py文件，按依赖顺序自动生成虚拟模块构造代码
• 自动提取每个文件的顶层对象（函数、类、全局变量）挂载到对应虚拟模块
• 最后追加目标same_step_x.py的代码，直接输出单个可执行的合并文件

注意事项 #

• 如果utils模块有嵌套子目录，按照层级依次构造父模块、子模块并注册即可
• 原有模块的全局变量、类定义都可以原样保留，挂载后作用域和原结构完全一致
• 不需要修改任何导入语句、调用逻辑，完全兼容原有业务代码的写法

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