Django后台面板：选择服务器任意文件夹现有图片且不重复

1. 用FilePathField替代ImageField #

这个字段可以指定服务器上的任意目录（比如整个media文件夹），直接选择已存在的图片，不会复制文件，仅存储文件的相对路径。配置示例：

from django.db import models
import os
from django.conf import settings

class Article(models.Model):
    img = models.FilePathField(
        path=os.path.join(settings.MEDIA_ROOT),
        recursive=True,  # 允许遍历子文件夹
        match=r'.*\.(jpg|jpeg|png|gif)$',  # 仅显示图片格式文件
        verbose_name='图片'
    )

注意：该字段存储的是字符串路径，而非ImageField的File对象，模板中显示图片时需手动拼接MEDIA_URL：

<img src="{{ MEDIA_URL }}{{ article.img }}" alt="文章配图">

2. 自定义字段（保留ImageField的预览特性） #

如果想保留ImageField自带的图片预览、尺寸验证等功能，可以自定义字段继承ImageField，重写保存逻辑避免复制文件：

from django.db import models
import os
from django.conf import settings

class ExistingImageField(models.ImageField):
    def save_form_data(self, instance, data):
        # 若传入的是已存在的文件路径，直接赋值不复制
        if data and isinstance(data, str) and os.path.exists(os.path.join(settings.MEDIA_ROOT, data)):
            setattr(instance, self.name, data)
        else:
            # 新上传文件仍按原逻辑处理
            super().save_form_data(instance, data)

# 使用时替换原ImageField即可
class Article(models.Model):
    img = ExistingImageField(verbose_name='图片', blank=True, null=True)

3. 后台选图优化：自定义表单控件 #

为了让后台选图更直观，可在admin中添加下拉框列出所有media内的图片：

from django.contrib import admin
from django import forms
from .models import Article
import os
from django.conf import settings

# 遍历media文件夹，获取所有图片的相对路径
def get_all_images():
    image_list = []
    for root, _, files in os.walk(settings.MEDIA_ROOT):
        for file in files:
            if file.lower().endswith(('.jpg', '.jpeg', '.png', '.gif')):
                rel_path = os.path.relpath(os.path.join(root, file), settings.MEDIA_ROOT)
                image_list.append((rel_path, rel_path))
    return image_list

class ArticleAdminForm(forms.ModelForm):
    img = forms.ChoiceField(choices=get_all_images(), required=False)

    class Meta:
        model = Article
        fields = '__all__'

class ArticleAdmin(admin.ModelAdmin):
    form = ArticleAdminForm

admin.site.register(Article, ArticleAdmin)

这样后台选图时直接下拉选择即可，选中后仅存储路径，不会生成副本。

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