理解精度丢失的根源
初看起来，精度丢失似乎发生在字符串到数字的转换（?number）或取绝对值（?abs）的过程中。然而，这是一种常见的误解。实际上，?number内置函数负责将字符串解析为freemarker内部的数值类型，而?abs则用于获取该数值的绝对值，这两个操作本身并不会导致精度丢失。freemarker在内部处理数字时会尽可能保留其原始精度。
真正的精度丢失发生在数字再次被转换为字符串进行输出的环节。当Freemarker模板引擎将一个数值类型输出到最终的文本流时，它会根据当前环境的number_format设置进行格式化。这个number_format通常用于本地化显示，例如根据语言环境决定小数点符号、千位分隔符以及小数位数。如果number_format被设置为类似"0.###"的格式，那么所有输出的数字都将被四舍五入到三位小数，从而导致原始精度信息的丢失。
解决方案：使用 ?c (计算机格式)
为了避免这种由格式化引起的精度丢失，Freemarker提供了一个非常有用的内置函数：?c，即“计算机格式”（Computer Format）。当你在输出数字时使用?c，Freemarker会以一种不进行本地化格式化的方式来表示数字，确保其原始精度得到保留。
?c内置函数具有以下关键特性：
- 小数点分隔符： 始终使用点（.）作为小数点分隔符，不受本地化设置影响。
- 千位分隔符： 绝不使用千位分隔符（如3,000,000）。
- 精度： 会显示多达16位小数，足以满足大多数高精度计算的需求。
- 无四舍五入： 不会根据number_format进行四舍五入或截断。
示例：演示问题与解决方案
假设我们有一个字符串变量a.value，其值为"-1.234567"。
问题示例（可能导致精度丢失）：
<#-- 假设当前的 number_format 设置为 "0.###" -->
<#assign a = {"value": "-1.234567"}>
<#if a.value?is_string>
<#-- 将字符串转换为数字 -->
<#assign numValue = a.value?number>
<#-- 获取绝对值 -->
<#assign absValue = numValue?abs>
<#-- 直接输出，受 number_format 影响 -->
"aValue_rounded": "${absValue}"
<#-- 预期输出: 1.234567 (如果 number_format 不限制) -->
<#-- 实际输出: 1.235 (如果 number_format 为 "0.###") -->
在上述示例中，如果number_format设置为"0.###"，那么"${absValue}"的输出将是1.235，而不是期望的1.234567。
解决方案示例（使用 ?c 避免精度丢失）：
<#-- 无论 number_format 设置如何，都保证精确输出 -->
<#assign a = {"value": "-1.234567"}>
<#if a.value?is_string>
<#-- 将字符串转换为数字 -->
<#assign numValue = a.value?number>
<#-- 获取绝对值 -->
<#assign absValue = numValue?abs>
<#-- 使用 ?c 进行精确输出 -->
"aValue_precise": "${absValue?c}"
<#-- 实际输出: 1.234567 -->
通过在输出时使用${absValue?c}，无论number_format如何设置，我们都能确保数字1.234567被完整且精确地输出。
应用场景与注意事项
- 机器可读数据： 当你生成的输出（例如JSON、XML、CSV文件或API响应）需要被其他程序解析时，使用?c至关重要。在这种情况下，任何由本地化格式引起的格式变化都可能导致解析错误或数据不准确。
- 精确数值显示： 对于需要精确显示财务数据、科学数据或其他高精度数值的场景，?c是确保数据完整性的首选。
- 用户界面显示： 如果数字是为最终用户显示，并且需要符合当地的数字格式习惯（例如，欧洲地区使用逗号作为小数点），则不应使用?c，而应依赖number_format进行本地化。
- number_format设置： 你可以在Freemarker配置中全局设置number_format，也可以在模板中使用来局部调整。但请记住，这些设置会被?c内置函数绕过。
总结
在Freemarker模板中，将字符串转换为数字并取绝对值后，若发现输出精度丢失，其根本原因在于数字在转换为字符串输出时受到了number_format设置的本地化格式化影响。为了避免这种不必要的四舍五入或截断，特别是当输出需要被机器解析时，应始终使用?c内置函数（例如${yourNumber?c}）来确保数字以精确的、计算机友好的格式输出。理解并正确运用?c是编写健壮、精确Freemarker模板的关键一步。
