Django Admin中FileField状态修改及学生文件批量导入问题

一、支持单个学生多文件上传与Admin显示 #

1. 修正模型设计 #

你的Student模型里的files字段是FileField，它只能存储单个文件的路径，每次上传新文件都会覆盖旧值，这就是只显示最后一个文件的核心原因。需要改成一对多关联模型来支持多文件：

# models.py
from django.db import models

class Student(models.Model):
    name = models.CharField(max_length=400, null=True, blank=True)
    codePerm = models.CharField(max_length=200, null=True, unique=True)  # 建议设为唯一，方便后续文件匹配

class StudentFile(models.Model):
    student = models.ForeignKey(Student, on_delete=models.CASCADE, related_name='files')
    file = models.FileField(upload_to='student_files/')  # 文件会自动上传到media/student_files目录
    upload_time = models.DateTimeField(auto_now_add=True)  # 可选，记录文件上传时间

    def __str__(self):
        return f"{self.student.name} - {self.file.name}"

2. 修改Admin配置 #

用InlineModelAdmin把学生的文件列表嵌入到Student的Admin页面，这样就能直接在学生详情页看到所有关联文件，还能批量添加：

# admin.py
from django.contrib import admin
from import_export.admin import ImportExportModelAdmin
from .models import Student, StudentFile

class StudentFileInline(admin.TabularInline):
    model = StudentFile
    extra = 1  # 默认显示1个新增文件的输入框

@admin.register(Student)
class StudentAdmin(ImportExportModelAdmin):
    list_display = ('name', 'codePerm')
    inlines = [StudentFileInline]  # 嵌入文件列表到学生Admin页

@admin.register(StudentFile)
class StudentFileAdmin(admin.ModelAdmin):
    list_display = ('student', 'file', 'upload_time')

3. 模板中获取所有文件 #

在模板里通过学生对象的files关联属性（已设置related_name='files'）就能拿到该学生的所有文件：

<!-- 模板示例代码 -->
{% for student in students %}
    <h3>{{ student.name }}</h3>
    <ul>
        {% for file in student.files.all %}
            <li><a href="{{ file.file.url }}">{{ file.file.name }}</a></li>
        {% empty %}
            <li>无上传文件</li>
        {% endfor %}
    </ul>
{% endfor %}

二、批量导入1万+学生的本地文件 #

1. 前置准备 #

• 确保本地文件命名包含学生的codePerm，比如STU001_file1.pdf、STU001_file2.docx，通过文件名能直接匹配到对应学生。
• 把所有待导入文件放到同一个目录下，比如/path/to/student_local_files/。

2. 编写批量处理脚本 #

写一个Django脚本（需在Django环境下运行），自动匹配学生与文件并批量导入：

# batch_import_files.py
import os
from django.core.files import File
from django.conf import settings
from your_app.models import Student, StudentFile  # 替换成你的app名称

# 本地文件存放目录
FILE_DIR = "/path/to/student_local_files/"

def batch_import():
    # 遍历目录下所有文件
    for filename in os.listdir(FILE_DIR):
        file_path = os.path.join(FILE_DIR, filename)
        if os.path.isfile(file_path):
            # 从文件名提取codePerm，这里假设文件名格式是{codePerm}_xxx.xxx
            # 根据你的实际命名规则调整分割逻辑
            code_perm = filename.split('_')[0]
            try:
                # 找到对应的学生
                student = Student.objects.get(codePerm=code_perm)
                # 创建StudentFile记录，将本地文件保存到media目录
                with open(file_path, 'rb') as f:
                    student_file = StudentFile(student=student)
                    student_file.file.save(filename, File(f), save=True)
                print(f"成功导入: {filename} -> 学生: {student.name}")
            except Student.DoesNotExist:
                print(f"未找到codePerm为{code_perm}的学生，跳过文件: {filename}")
            except Exception as e:
                print(f"导入{filename}失败: {str(e)}")

if __name__ == "__main__":
    # 配置Django环境（直接运行脚本需添加这段）
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "your_project.settings")  # 替换成你的项目settings
    import django
    django.setup()
    batch_import()

3. 运行脚本 #

在项目根目录下执行：

python batch_import_files.py

注意事项：

• 提前备份数据库和文件，避免操作出错。
• 文件数量过大时，可分批次处理或添加进度打印。
• 如果文件名规则不同，修改code_perm = filename.split('_')[0]逻辑适配你的命名格式。

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