如何优雅地存储带默认值的Python f-string模板？

一、用TOML存储模板与默认值 #

把模板字符串和对应字段的默认值统一存到TOML文件中，实现模板与代码解耦，修改或新增模板无需改动Python逻辑。示例templates.toml内容：

[template_1]
template = """
^FH\^FDLA,{identifier}^FS
^FT145,51FD{name}^FS^CI27
"""
defaults = { identifier = "default_id", name = "default_name" }

[template_2]
template = """
as{name}{project}
"""
defaults = { name = "different name", project = "default_project" }

[template_3]
template = """
asflkjasdf{person}{name}
"""
defaults = { name = "template3_name", person = "some person" }

二、Python类实现模板加载与渲染 #

通过类封装模板加载、参数合并、渲染逻辑，替代繁琐的if/else判断。代码如下：

# Python 3.11+ 可使用标准库 tomllib 替代 tomli
import tomli

class LabelTemplateManager:
    def __init__(self, toml_path):
        # 加载TOML中的所有模板配置
        with open(toml_path, 'rb') as f:
            self.template_configs = tomli.load(f)
    
    def render(self, template_name, **kwargs):
        # 校验模板是否存在
        if template_name not in self.template_configs:
            raise ValueError(f"不存在名为 {template_name} 的模板")
        
        config = self.template_configs[template_name]
        # 合并默认值与传入参数，传入参数优先级高于默认值
        render_params = config['defaults'].copy()
        render_params.update(kwargs)
        
        # 渲染模板
        return config['template'].format(**render_params)

三、使用示例 #

# 初始化模板管理器
manager = LabelTemplateManager('templates.toml')

# 场景1：仅传部分参数，其余用默认值
result1 = manager.render('template_1', identifier='LABEL_001')
print(result1)

# 场景2：覆盖部分默认值
result2 = manager.render('template_2', name='MyCustomProject')
print(result2)

# 场景3：覆盖所有默认值
result3 = manager.render('template_3', name='Alice', person='Engineer')
print(result3)

四、方案优势 #

• 模板与代码分离：新增或修改模板只需编辑TOML文件，无需改动Python业务逻辑
• 默认值独立配置：同名字段在不同模板下可设置不同默认值，完全满足需求
• 逻辑简洁高效：用字典合并替代多层if/else，代码可读性和维护性大幅提升
• 扩展性强：后续可轻松添加模板校验、渲染缓存、格式检查等功能

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