如何将Django模型数据导出为CSV/JSON/TXT文件？哪种方案最优？

一、dumpdata 是不是最佳选择？ #

dumpdata 是Django自带的工具，适合导出全量模型数据到JSON/YAML/XML，优点是不用额外写代码，能自动处理模型关联（默认会嵌套外键数据），还能指定单个app或模型——比如你用的python3 manage.py dumpdata myapps > myapps.json就是导出整个app的所有数据。

但它有明显局限：没法直接导出过滤后的行数据（比如只导出状态为active的记录），也不能自定义导出字段，而且不支持直接导出CSV/TXT。所以如果你的需求是全量JSON/YAML导出，它是不错的选择；但如果要导出部分数据、自定义格式，它就不是最优方案了。

二、不同格式的最优导出方案 #

1. JSON 格式 #

• 全量数据导出：继续用dumpdata，可以加参数优化输出：
  • 导出单个模型：python3 manage.py dumpdata myapps.MyModel --indent 4 > mymodel.json（--indent让JSON更易读）
  • 只导出外键ID（不嵌套关联数据）：python3 manage.py dumpdata myapps.MyModel --natural-foreign --indent 4 > mymodel.json
• 过滤/自定义字段导出：用Django Shell或者写自定义管理命令：
  Shell示例（临时用很方便）：

  from django.core import serializers
  from myapps.models import MyModel
  
  # 过滤出状态为active的记录，只导出指定字段
  filtered_data = MyModel.objects.filter(status='active')
  json_data = serializers.serialize('json', filtered_data, fields=('id', 'name', 'created_at'))
  with open('filtered_mymodel.json', 'w') as f:
      f.write(json_data)
  

  要是需要反复用，就写个自定义manage命令，把逻辑封装进去。

2. CSV 格式 #

CSV适合表格化数据，dumpdata不直接支持，最优方式是写自定义管理命令（可复用）：
在你的app下创建management/commands/export_csv.py，代码如下：

import csv
from django.core.management.base import BaseCommand
from myapps.models import MyModel

class Command(BaseCommand):
    help = '导出MyModel数据到CSV文件'

    def add_arguments(self, parser):
        parser.add_argument('output_file', type=str, help='导出文件路径')

    def handle(self, *args, **options):
        # 这里可以加过滤条件，比如.filter(status='active')
        queryset = MyModel.objects.all().values('id', 'name', 'email', 'created_at')
        if not queryset.exists():
            self.stdout.write(self.style.WARNING('没有数据可导出'))
            return
        with open(options['output_file'], 'w', newline='', encoding='utf-8') as csvfile:
            writer = csv.DictWriter(csvfile, fieldnames=queryset[0].keys())
            writer.writeheader()
            writer.writerows(queryset)
        self.stdout.write(self.style.SUCCESS(f'数据已成功导出到 {options["output_file"]}'))

使用命令：python3 manage.py export_csv mymodel_data.csv

临时导出也可以直接用Shell，和上面JSON的思路类似，用csv.DictWriter写数据就行。

3. TXT 格式 #

TXT格式完全看你要的文本结构，比如每行一条记录、用分隔符分隔字段，直接用Shell或自定义命令处理：
Shell示例：

from myapps.models import MyModel

# 过滤数据，指定字段
queryset = MyModel.objects.filter(status='active').values_list('id', 'name', 'created_at')
with open('mymodel_data.txt', 'w', encoding='utf-8') as f:
    for row in queryset:
        # 自定义格式，比如用|分隔，日期转成字符串
        f.write(f"{row[0]}|{row[1]}|{row[2].strftime('%Y-%m-%d %H:%M:%S')}\n")

三、对比直接从数据库复制数据 #

直接用数据库工具（比如pg_dump、mysql导出）的优点是速度快，适合超大数据集；但缺点也很明显：

• 跳过Django的模型逻辑，比如时区转换、字段验证、信号触发，导出的数据可能和Django处理后的不一致
• 没法用Django的ORM过滤、字段选择，得写复杂的SQL
• 导出的是原始数据库格式，要适配Django模型得额外处理

所以如果数据量不大，优先用Django自带的方式，保证数据和模型逻辑一致；如果是超大数据集，再考虑直接数据库导出。

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