讲讲django的文件对象

一、django文件对象是什么？

Django 抽象出了一套“文件处理体系”，核心是：

• Django 所有文件类的基类
• 提供统一的接口用于：

  • 读取

  • 写入

  • 迭代

  • 存储到 Storage 后端（本地/OSS/S3）

使用FileField / ImageField来构造：

class MyModel(models.Model):file = models.FileField(upload_to='files/')

这个字段对文件内容不做存储，只存储 文件路径字符串。

真正的文件保存由：

• django.core.files.File

• 一套 Storage（默认本地文件系统）

obj.file.save('result.txt', ContentFile('hello world'))

此时 Django 会：

1. 把 ContentFile 写入本地或 OSS 或 S3

2. 把保存后的路径写到数据库字段 file

二、不同场景下该用哪种 Django 文件对象

场景 1：用户上传文件（常见 Web/DRF）

def upload(request):f = request.FILES['file']  # InMemoryUploadedFile 或 TemporaryUploadedFileprint(f.name, f.size, f.content_type)

场景 2：动态生成一个文件（如 CSV/JSON/图片），并保存到 FileField

from django.core.files.base import ContentFilecontent = "name,age\nTom,18\nJerry,20"
obj.file.save("data.csv", ContentFile(content))

场景 3：用 Python open 打开的本地文件，写入 FileField

from django.core.files import Filewith open('local.txt', 'rb') as f:obj.file.save('copy.txt', File(f))

三、几种文件存储的对应配置

1.本地存储：我就想存到服务器磁盘

Django 默认就是本地磁盘文件存储，用的类是：

DEFAULT_FILE_STORAGE = 'django.core.files.storage.FileSystemStorage'

在 settings.py 里：

import os
BASE_DIR = os.path.dirname(os.path.dirname(__file__))MEDIA_ROOT = os.path.join(BASE_DIR, 'media')  # 真实文件保存路径
MEDIA_URL = '/media/'                         # 浏览器访问前缀

模型配置：

class MyModel(models.Model):file = models.FileField(upload_to='uploads/')

最后

obj.file.save('a.txt', ContentFile('hello'))

实际效果是：

• 文件会被保存到：MEDIA_ROOT / uploads / a.txt
• 例如：/project_root/media/uploads/a.txt
• 数据库里的字段只保存相对路径：uploads/a.txt
• 浏览器访问地址是：MEDIA_URL + 'uploads/a.txt' → /media/uploads/a.txt

访问文件，只需要在url.py加一个静态路由:

from django.conf import settings
from django.conf.urls.static import staticurlpatterns = [# ... 你的其他 URL
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

2.上云存储：S3/OSS/COS/BOS 等

1）用现成库（如 django-storages + S3 为例），需要安装：

pip install django-storages boto3

settings.py配置：

INSTALLED_APPS = [# ...'storages',
]DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'AWS_ACCESS_KEY_ID = '你的Key'
AWS_SECRET_ACCESS_KEY = '你的Secret'
AWS_STORAGE_BUCKET_NAME = '你的bucket名字'
AWS_S3_ENDPOINT_URL = 'https://s3.amazonaws.com'  # 若用其他云厂商，写他们给的S3兼容endpoint
MEDIA_URL = 'https://你的bucket域名/'   # 访问 URL 前缀

模型不需要改动：

class MyModel(models.Model):file = models.FileField(upload_to='files/')

业务代码：

obj.file.save('a.txt', ContentFile('hello cloud'))

Django 会：

• 把文件内容通过 S3 API 上传到你的 bucket：files/a.txt
• 数据库字段还是保存 files/a.txt
• 页面访问路径是：MEDIA_URL + 'files/a.txt'，比如：https://your-bucket.xxx.com/files/a.txt