Python中是否存在可批量替换模板文件内所有变量的函数或模块？

你之前考虑的双层循环遍历模板内容、逐个匹配配置项做硬替换的方式，很容易踩坑：比如替换顺序不对、值里的特殊字符导致误替换、嵌套变量要反复循环才能替换完，Python生态里有好几种成熟的现成实现，完全不需要自己造轮子：

标准库零依赖方案（1:1对齐Ant的替换行为） #

Python内置的string.Template天生就是为处理${var}风格的变量替换设计的，和你现有模板、配置的格式完全兼容，不需要修改任何现有模板的占位符写法。
核心实现逻辑非常简洁，完全不需要手写双层遍历，示例代码：

from string import Template
from pathlib import Path

# 读取无分节的Java Properties格式配置（即dev.properties这类文件）
env_config = {}
with Path("env_config/dev.properties").open(encoding="utf-8") as f:
    for line in f:
        line = line.strip()
        # 跳过空行、注释行
        if not line or line.startswith(("#", "!")):
            continue
        key, value = line.split("=", 1)
        env_config[key.strip()] = value.strip()

# 加载模板并完成替换
template_text = Path("template/configplan-template.xml").read_text(encoding="utf-8")
rendered_content = Template(template_text).substitute(env_config)

# 输出最终文件
Path("output/configplan.xml").write_text(rendered_content, encoding="utf-8")

这个方案的特性：

• 完全复刻Ant replace的行为：占位符识别严格匹配${xxx}格式，不会误替换普通文本
• 替换逻辑由标准库实现，不存在自写双层循环的常见bug：不会因为处理顺序不对，把替换值里带的$字符当占位符做二次替换
• 校验能力更强：调用substitute方法时，如果模板里存在没在配置中定义的占位符，会直接抛出明确的异常，能提前发现漏配的环境变量，不会静默输出带残留占位符的无效文件
• 如果你的环境配置是带节的标准INI格式，直接用内置的configparser模块读取就行，连手动逐行读配置的循环都可以省掉。

适配复杂场景的第三方模板方案 #

如果后续你的模板需要支持更灵活的能力（比如嵌套变量替换、简单条件判断、值的格式格式化），可以直接用成熟的通用模板引擎，不需要自己扩展替换逻辑：

• 最常用的是Jinja2：很多人以为它只能做Web页面渲染，其实只要简单调整下占位符的起止标记，就能完全兼容你现有${xxx}的模板写法，不需要修改现有模板的任何内容。
  适配示例：

from jinja2 import Environment
from pathlib import Path

# 把Jinja2的变量分隔符改成和现有模板完全一致的${}风格
render_env = Environment(
    variable_start_string="${",
    variable_end_string="}",
)

# 读取配置逻辑和前面一致
env_config = {}
with Path("env_config/dev.properties").open(encoding="utf-8") as f:
    for line in f:
        line = line.strip()
        if line and not line.startswith("#"):
            k, v = line.split("=", 1)
            env_config[k.strip()] = v.strip()

# 渲染输出
template = render_env.from_string(Path("template/configplan-template.xml").read_text(encoding="utf-8"))
output_text = template.render(**env_config)
Path("output/configplan.xml").write_text(output_text, encoding="utf-8")

这个方案的额外特性：

• 自动支持嵌套变量替换：比如配置里定义base_url=https://${host}:${port}，库会自动递归完成所有层级的变量替换，不用自己写循环反复扫描全文档直到没有匹配项
• 支持变量默认值、简单判断逻辑：比如模板里可以写${db_port | default(3306)}，配置没写的时候就自动用默认值，不会直接报错中断流程
• 自带文本转义能力：比如替换XML里的属性值时，会自动处理特殊字符，避免破坏模板结构。

内容的提问来源于stack exchange，提问作者Martijn van der Kamp