Shopify Liquid带分期手续费的12期计算报错如何解决

原有代码报错&结果错误原因 #

• Liquid 语法不支持直接使用%作为百分比运算符，所有百分比值需要提前转换为小数参与运算，17.28%对应的运算值为0.1728
• Liquid 仅识别.作为小数分隔符，原代码中17,28的逗号写法属于非法参数，会直接触发解析报错
• 原代码运算逻辑错误：叠加17.28%手续费的计算逻辑为「原价 * (1 + 手续费率)」，而非原价除以费率；同时Liquid链式过滤器默认按从左到右顺序执行，不会自动匹配数学运算优先级，直接链式写多步运算很容易出现结果偏差
• Liquid的plus过滤器仅支持传入固定数值做加法，不能直接在参数里嵌套其他运算逻辑

正确实现代码 #

推荐通过assign标签拆分计算步骤，可读性更高也方便后续调整费率、期数参数：

<p style="font-size: 18px">
  {% comment %} 可按需修改以下两个参数调整期数和手续费率 {% endcomment %}
  {% assign installment_period = 12.0 %}
  {% assign fee_rate = 0.1728 %}
  {% assign total_price_multiplier = fee_rate | plus: 1 %}
  {% assign total_with_fee = product.price | times: total_price_multiplier %}
  {% assign per_installment = total_with_fee | divided_by: installment_period | round: 2 %}
  ou 12x de
  <span style="color: #00dd70">{{ per_installment | money }}</span>
  {% comment %} 原代码中sem juros为葡萄牙语“免息”含义，当前计算为含手续费结果，可按需替换文案 {% endcomment %}
  sem juros
</p>

开发注意事项 #

• Shopify的product.price返回值是商品最小货币单位（如人民币返回分、美元返回美分）的整数值，不需要手动做单位转换，money过滤器会自动按店铺货币配置渲染正确的金额格式
• Liquid的divided_by过滤器如果传入整数类型参数，会默认对结果做整除取整，丢失小数精度；需要精确金额结果时，要将除数写为小数值（比如12.0），或在运算后追加times: 1.0强制转换为浮点类型
• 追加round: 2过滤器是为了避免浮点运算产生多位小数，保证金额结果符合常规货币显示规则

内容的提问来源于stack exchange，提问作者Luiz N. Sidião