使用Django import-export模块导入CSV时CHAR字段纯数值导入失败

问题根源 #

1. CSV格式问题：使用表格软件编辑CSV时，纯数值单元格会被自动识别为数值类型并以无引号的数值形式保存，import-export模块默认的CSV解析器会将这类数值视为非字符串类型，无法匹配DjangoCharField的字符串要求，最终导致导入时该字段为空。
2. import-export默认处理限制：默认的CharWidget不会主动将解析得到的数值类型转换为字符串，纯数值内容因此无法被正确映射到CharField中。
3. Django的CharField本身支持字符串形式的数字，字段定义不存在问题。

解决方法 #

方法1：修正CSV文件格式 #

在表格软件中将纯数值列设置为文本格式后再保存CSV：

• 以Excel为例：选中目标列 → 右键选择「设置单元格格式」→ 选择「文本」→ 刷新单元格内容（重新输入或双击单元格确认）→ 保存为CSV格式。此时纯数值会被引号包裹，解析时会被识别为字符串。

方法2：自定义import-export的Resource处理逻辑 #

在admin.py中自定义Resource类，重写对应字段的widget，强制将数值转为字符串：

from import_export import resources
from import_export.admin import ImportExportModelAdmin
from import_export.fields import Field
from import_export.widgets import Widget
from django.contrib import admin
import your_app.models as models

# 自定义Widget，负责将数值转为字符串
class StringConverterWidget(Widget):
    def clean(self, value, row=None, *args, **kwargs):
        # 处理数值类型，转为字符串；空值返回空字符串
        if isinstance(value, (int, float)):
            return str(value)
        return str(value) if value is not None else ""

# 自定义Resource类
class CardResource(resources.ModelResource):
    # 替换成你实际的目标字段名，比如'card_number'
    target_field = Field(attribute='target_field', widget=StringConverterWidget())

    class Meta:
        model = models.Card
        fields = ('id', 'target_field',)  # 列出所有需要导入导出的字段

# 自定义Admin类
class CardAdmin(ImportExportModelAdmin, admin.ModelAdmin):
    resource_class = CardResource

admin.site.register(models.Card, CardAdmin)

该方法会在导入流程中自动将解析到的数值类型转为字符串，确保纯数值内容能正确存入CharField。

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