如何基于存储的收据模板替换占位符、设置宽度对齐及小数位数

1. 提前准备基础配置 #

你需要先整理三类配置信息，统一存储即可：

• 占位符映射字典：将所有@开头的占位符和对应的业务字段一一绑定，示例结构如下：

  placeholder_map = {
      "@10": "QTY",
      "@11": "ITEM",
      "@12": "Price",
      "@01": "门店名称",
      "@04": "收银时间",
      # 补全其余所有占位符的映射关系
  }
  

• 字段样式规则：给每个业务字段配置宽度、对齐方式、小数位数参数，示例结构如下：

  field_style = {
      "QTY": {"width": 6, "align": "right", "decimal": 0},
      "ITEM": {"width": 22, "align": "left", "decimal": 0},
      "Price": {"width": 10, "align": "right", "decimal": 2},
      "门店名称": {"width": 15, "align": "left", "decimal": 0},
      # 补全其余字段的样式规则
  }
  

• 拆分数据源：把要填充的数据分成两类，一类是整张收据只有一个值的公共数据（比如门店名、收银员、桌号），另一类是多条的商品明细数组数据。

2. 拆分模板分区域渲染 #

首先以特殊标记$D:0为分界，把模板切割为上下两个区域：

固定内容区（$D:0 上方区域） #

逐行遍历该区域的模板内容，按以下逻辑处理：

1. 正则匹配当前行内所有@开头的占位符
2. 对每个匹配到的占位符，先从映射字典拿到对应字段名，再从公共数据源取到对应值
3. 调用格式处理函数，按照该字段的样式规则把值处理为指定宽度、对齐、小数精度的字符串
4. 用处理后的字符串替换对应占位符，整行替换完成后输出该行内容

明细重复区（$D:0 下方区域） #

该区域的模板行是明细的渲染模板，按以下逻辑处理：

1. 先提取明细行模板内容
2. 遍历商品明细数组的每一条数据：
   • 替换当前明细数据对应的所有占位符，同样按样式规则格式化字段值
   • 每一条数据生成一行格式化后的内容，依次输出
3. 所有明细输出完成后，如果有合计、备注等后续固定内容，继续按固定内容区的逻辑处理即可

3. 核心格式处理逻辑示例 #

以下是单字段格式化的伪代码，可直接套用：

def format_field(raw_value, style_config):
    # 先处理小数位数
    if style_config["decimal"] > 0:
        formatted_val = f"{float(raw_value):.{style_config['decimal']}f}"
    else:
        formatted_val = str(raw_value)
    # 处理对齐和宽度，超出宽度自动截断
    if style_config["align"] == "left":
        return formatted_val.ljust(style_config["width"])[:style_config["width"]]
    elif style_config["align"] == "right":
        return formatted_val.rjust(style_config["width"])[:style_config["width"]]
    else:
        return formatted_val.center(style_config["width"])[:style_config["width"]]

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