django文件对象是什么?

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

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

    • 写入

    • 迭代

    • 存储到 Storage 后端(本地/OSS/S3)

使用FileField/ImageField来构造:

1

2

classMyModel(models.Model):

file=models.FileField(upload_to='files/')

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

真正的文件保存由:

  • django.core.files.File

  • 一套 Storage(默认本地文件系统)

1

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

此时 Django 会:

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

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

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

场景 1:用户上传文件(常见 Web/DRF)

1

2

3

defupload(request):

f=request.FILES['file']# InMemoryUploadedFile 或 TemporaryUploadedFile

print(f.name, f.size, f.content_type)

场景 2:动态生成一个文件(如 CSV/JSON/图片),并保存到 FileField

1

2

3

4

fromdjango.core.files.baseimportContentFile

content="name,age\nTom,18\nJerry,20"

obj.file.save("data.csv", ContentFile(content))

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

1

2

3

4

fromdjango.core.filesimportFile

withopen('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

importos

BASE_DIR=os.path.dirname(os.path.dirname(__file__))

MEDIA_ROOT=os.path.join(BASE_DIR,'media')# 真实文件保存路径

MEDIA_URL='/media/'# 浏览器访问前缀

模型配置:

1

2

classMyModel(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

fromdjango.confimportsettings

fromdjango.conf.urls.staticimportstatic

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

classMyModel(models.Model):

file=models.FileField(upload_to='files/')

业务代码:

1

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

Django 会: