如何在Python中实现类似C语言#include的文本替换式文件引入功能

方案1：直接使用C预处理器（最省事，完全符合文本替换需求） #

不需要自己造轮子，直接用系统自带的C预处理器即可完美匹配需求：

• 用法：在你的Python代码中直接写#include "xxx.py"语法，执行以下命令生成合并后的单文件：

cpp -P -x c main.py > final.py

• 参数说明：
  • -P：去掉预处理器生成的行号标记，不会输出额外干扰内容
  • -x c：强制按照C语法解析预处理器指令，忽略Python语法差异
• 优势：原生支持嵌套引入、条件编译、宏定义等所有C预处理器功能，完全是你要的纯文本复制替换逻辑。

方案2：自定义Python预处理器脚本（最灵活，无语法冲突） #

如果C预处理器的语法和你的Python代码有冲突（比如代码字符串中出现#define类的标记），可以自己写一个轻量预处理器，核心逻辑不到50行，示例如下：

import os
import re

INCLUDE_PATTERN = re.compile(r'^\s*#\s*include\s*["<](.+?)[">]\s*$', re.MULTILINE)
processed_files = set()

def process_file(file_path, base_path=None):
    file_path = os.path.abspath(file_path if base_path is None else os.path.join(base_path, file_path))
    if file_path in processed_files:
        return ""
    processed_files.add(file_path)
    current_base = os.path.dirname(file_path)
    with open(file_path, 'r', encoding='utf-8') as f:
        content = f.read()
    def replace_include(match):
        include_file = match.group(1)
        return process_file(include_file, current_base)
    return INCLUDE_PATTERN.sub(replace_include, content)

if __name__ == '__main__':
    import sys
    if len(sys.argv) != 3:
        print("用法：python preprocess.py 入口文件.py 输出文件.py")
        sys.exit(1)
    merged_content = process_file(sys.argv[1])
    with open(sys.argv[2], 'w', encoding='utf-8') as f:
        f.write(merged_content)

• 功能特性：
  • 自动跳过已处理文件，避免重复引入导致的变量/函数重定义问题
  • 支持相对路径嵌套引入
  • 可自行修改匹配规则，比如把引入标记改成# @include避免语法冲突
  • 可扩展添加自定义逻辑，比如自动删除调试代码、添加版权声明等

方案3：工程化构建方案（适合多文件大型项目） #

如果你的项目文件较多，需要增量构建、依赖检测，可以结合构建工具使用：

• 编写Makefile或者Justfile，把合并逻辑写成构建规则，仅当依赖的py文件修改时才重新生成最终文件
• 可以和代码检查、格式化、单元测试等流程串联，适配开发工作流

注意事项 #

• 所有方案都要注意引入顺序，依赖代码需要早于调用代码引入
• 自定义脚本可以添加循环引入检测，避免死循环
• 如果最终生成的单文件需要发布，可以配合autopep8等格式化工具自动整理合并后的代码格式

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