如何在Django模型中添加可在后台选择的目录字段？

你的代码中使用的FilePathField默认仅支持选择文件，而非目录，这就是后台无法选择目录的原因。要实现目录选择功能，需要自定义字段或Admin表单逻辑，以下是具体实现方案：

方案1：替换字段并自定义Admin表单（基础版） #

步骤1：修改模型字段 #

将FilePathField替换为CharField，并添加目录验证器确保输入的是有效目录：

from django.db import models
from django.core.exceptions import ValidationError
import os
from django.conf import settings
from django.utils.translation import gettext_lazy as _

def validate_directory_path(value):
    # 验证路径是否为有效目录
    if not os.path.isdir(value):
        raise ValidationError(_("مسیر وارد شده یک دایرکتوری معتبر نیست"))
    # 可选：限制目录必须在备份根目录下
    backup_root = os.path.join(settings.BASE_DIR.parent, "backups")
    if not value.startswith(backup_root):
        raise ValidationError(_("مسیر باید زیر دایرکتوری backups باشد"))

class Backup(Authorable, Publishable, models.Model):
    file_path = models.CharField(
        _("مسیر دایرکتوری"),
        max_length=255,
        validators=[validate_directory_path]
    )
    file_size = models.CharField(verbose_name=_("حجم فایل"), max_length=255, null=True, blank=True)
    
    class Meta:
        verbose_name = _("تهیه پشتیبان")
        verbose_name_plural = _("تهیه پشتیبان")
        
    def __str__(self):
        return f"{self.id} - {self.file_path} - {self.file_size}"
    
    def save(self, **kwargs):
        BackupService.run(self.file_path)
        return super().save(**kwargs)

步骤2：自定义Admin表单实现目录下拉选择 #

在admin.py中编写自定义表单，动态扫描备份目录并生成选择项：

from django.contrib import admin
from django import forms
from .models import Backup
import os
from django.conf import settings
from django.utils.translation import gettext_lazy as _

def get_backup_directories():
    """扫描备份根目录下的所有子目录，生成选项"""
    backup_root = os.path.join(settings.BASE_DIR.parent, "backups")
    dir_options = []
    # 递归遍历所有目录
    for root, _, _ in os.walk(backup_root):
        # 生成友好的显示名称（相对路径）
        rel_path = os.path.relpath(root, backup_root)
        display_name = root if rel_path == "." else rel_path
        dir_options.append((root, display_name))
    return dir_options

class BackupAdminForm(forms.ModelForm):
    file_path = forms.ChoiceField(
        label=_("انتخاب دایرکتوری"),
        choices=()
    )

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        # 每次加载表单时刷新目录列表
        self.fields['file_path'].choices = get_backup_directories()

    class Meta:
        model = Backup
        fields = "__all__"

@admin.register(Backup)
class BackupAdmin(admin.ModelAdmin):
    form = BackupAdminForm

方案2：支持创建新目录（进阶版） #

如果需要让用户在后台直接创建新目录，可以扩展表单逻辑：

class BackupAdminForm(forms.ModelForm):
    file_path = forms.ChoiceField(
        label=_("انتخاب دایرکتوری موجود"),
        choices=(),
        required=False
    )
    new_directory = forms.CharField(
        label=_("ایجاد دایرکتوری جدید"),
        max_length=255,
        required=False,
        help_text=_("مثلاً: monthly/2024_june")
    )

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.fields['file_path'].choices = get_backup_directories()

    def clean(self):
        cleaned_data = super().clean()
        existing_dir = cleaned_data.get('file_path')
        new_dir = cleaned_data.get('new_directory')

        # 确保至少选择或输入一个目录
        if not existing_dir and not new_dir:
            raise ValidationError(_("لطفاً یک دایرکتوری موجود انتخاب کنید یا یک دایرکتوری جدید ایجاد کنید"))
        
        # 处理新目录创建逻辑
        if new_dir:
            backup_root = os.path.join(settings.BASE_DIR.parent, "backups")
            full_new_path = os.path.join(backup_root, new_dir)
            if os.path.exists(full_new_path):
                raise ValidationError(_("این دایرکتوری уже وجود دارد"))
            try:
                # 创建目录（包括父目录）
                os.makedirs(full_new_path, exist_ok=True)
                cleaned_data['file_path'] = full_new_path
            except OSError as e:
                raise ValidationError(_("خطا در ایجاد دایرکتوری: %(error)s") % {'error': str(e)})
        
        return cleaned_data

    class Meta:
        model = Backup
        fields = ('file_path', 'new_directory', 'file_size')

注意事项 #

• 确保Django运行进程拥有备份目录的读写权限，否则无法扫描或创建目录。
• 如果备份目录结构频繁变化，方案1中的get_backup_directories会每次加载表单时重新扫描，保证目录列表是最新的。

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