Django Import Export 项目中数字格式化问题的分析与解决方案

在 Django Import Export 项目中，数字格式化是一个常见的需求。近期项目中遇到了一个关于数字格式化的问题，特别是在处理千位分隔符和本地化数字格式时，导致导出文件无法重新导入的情况。本文将深入分析这个问题，并提供解决方案。

问题背景

在 Django 中，数字格式化通常依赖于 number_format 函数，该函数会根据 USE_THOUSAND_SEPARATOR 设置自动添加千位分隔符。然而，当导出包含数字的 CSV 文件时，如果数字大于 1000，导出的文件中会包含千位分隔符（如 "1,234"）。当尝试重新导入这个文件时，由于千位分隔符的存在，会导致解析失败，抛出 decimal.ConversionSyntax 错误。

问题复现

1. 在 settings.py 中启用 USE_THOUSAND_SEPARATOR = True。
2. 创建一个包含四位数字（如 1234）的模型实例。
3. 导出为 CSV 文件，数字会被格式化为 "1,234"。
4. 尝试重新导入该 CSV 文件时，解析失败。

问题分析

问题的核心在于 number_format 函数不仅处理了小数点分隔符，还处理了千位分隔符。虽然千位分隔符在用户界面中提高了可读性，但在数据交换（如 CSV 导入导出）时却带来了兼容性问题。特别是当数字被格式化为本地化形式（如法语中的 "1 234,56"）时，问题更加复杂。

解决方案

方案一：禁用千位分隔符

最简单的解决方案是在导出时禁用千位分隔符。可以通过自定义 Resource 类，临时覆盖语言设置来实现：

from django.utils import translation
from import_export import resources

class Resource(resources.Resource):
    def export(self, queryset=None, **kwargs):
        with translation.override("en-US-export"):
            return super().export(queryset, **kwargs)

这种方法虽然有效，但需要为每种语言创建特殊的语言变体，略显繁琐。

方案二：修改数字解析逻辑

更彻底的解决方案是修改 FloatWidget 和 DecimalWidget 的 clean 方法，使其能够处理包含千位分隔符和本地化小数点分隔符的数字。具体步骤如下：

1. 移除所有千位分隔符。
2. 将本地化小数点分隔符替换为标准小数点（.）。
3. 将处理后的字符串转换为浮点数或十进制数。

这种方法更加通用，能够处理各种本地化数字格式。

实现细节

以下是 FloatWidget 的 clean 方法的一个示例实现：

def clean(self, value, row=None, *args, **kwargs):
    if value is None:
        return None
    if isinstance(value, float):
        return value
    # 移除千位分隔符
    value = value.replace(",", "").replace(" ", "")
    # 替换本地化小数点分隔符
    value = value.replace(",", ".")
    try:
        return float(value)
    except ValueError:
        raise ValueError("Could not convert '%s' to float" % value)

结论