Django 抽象出了一套"文件处理体系"，核心是：
- Django 所有文件类的基类
- 提供统一的接口用于：
-
读取
-
写入
-
迭代
-
存储到 Storage 后端（本地/OSS/S3）
-
使用FileField / ImageField来构造：
|-----|---------------------------------------------------------------------------------------------|
| 1 2 | class MyModel(models.Model): ``file = models.FileField(upload_to``=``'files/'``) |
这个字段对文件内容不做存储，只存储 文件路径字符串。
真正的文件保存由：
-
django.core.files.File -
一套 Storage（默认本地文件系统）
|---|-----------------------------------------------------------------------|
| 1 | obj.``file``.save(``'result.txt'``, ContentFile(``'hello world'``)) |
此时 Django 会：
-
把 ContentFile 写入本地或 OSS 或 S3
-
把保存后的路径写到数据库字段
file
二、不同场景下该用哪种 Django 文件对象
场景 1：用户上传文件（常见 Web/DRF）
|-------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1 2 3 | def upload(request): ``f ``= request.FILES[``'file'``] ``# InMemoryUploadedFile 或 TemporaryUploadedFile ``print``(f.name, f.size, f.content_type) |
场景 2：动态生成一个文件（如 CSV/JSON/图片），并保存到 FileField
|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1 2 3 4 | from django.core.files.base ``import ContentFile content ``= "name,age\nTom,18\nJerry,20" obj.``file``.save(``"data.csv"``, ContentFile(content)) |
场景 3：用 Python open 打开的本地文件，写入 FileField
|---------|-------------------------------------------------------------------------------------------------------------------------------------------------|
| 1 2 3 4 | from django.core.files ``import File with ``open``(``'local.txt'``, ``'rb'``) as f: ``obj.``file``.save(``'copy.txt'``, ``File``(f)) |
三、几种文件存储的对应配置
1.本地存储：我就想存到服务器磁盘
Django 默认就是本地磁盘文件存储，用的类是：
|---|----------------------------------------------------------------------------|
| 1 | DEFAULT_FILE_STORAGE ``= 'django.core.files.storage.FileSystemStorage' |
在 settings.py 里：
|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1 2 3 4 5 | import os BASE_DIR ``= os.path.dirname(os.path.dirname(__file__)) MEDIA_ROOT ``= os.path.join(BASE_DIR, ``'media'``) ``# 真实文件保存路径 MEDIA_URL ``= '/media/' # 浏览器访问前缀 |
模型配置：
|-----|-----------------------------------------------------------------------------------------------|
| 1 2 | class MyModel(models.Model): ``file = models.FileField(upload_to``=``'uploads/'``) |
最后
|---|------------------------------------------------------------|
| 1 | 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加一个静态路由:
|-------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1 2 3 4 5 6 | from django.conf ``import settings from django.conf.urls.static ``import static urlpatterns ``= [ ``# ... 你的其他 URL ] ``+ static(settings.MEDIA_URL, document_root``=``settings.MEDIA_ROOT) |
2.上云存储：S3/OSS/COS/BOS 等
1）用现成库（如 django-storages + S3 为例），需要安装：
|---|-----------------------------------------|
| 1 | pip install django``-``storages boto3 |
settings.py配置：
|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 1 2 3 4 5 6 7 8 9 10 11 12 | 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 前缀 |
模型不需要改动：
|-----|---------------------------------------------------------------------------------------------|
| 1 2 | class MyModel(models.Model): ``file = models.FileField(upload_to``=``'files/'``) |
业务代码：
|---|------------------------------------------------------------------|
| 1 | obj.``file``.save(``'a.txt'``, ContentFile(``'hello cloud'``)) |
Django 会：