Django通過(guò)腳本上傳文件的詳細(xì)操作指南
更新時(shí)間：2025年07月24日 08:47:54 作者：Yant224
文件上傳是一個(gè)比較常用的網(wǎng)站功能,在服務(wù)器端,Django會(huì)使用一個(gè)叫作request.FILES的對(duì)象來(lái)處理上傳的文件,本文給大家介紹了Django通過(guò)腳本上傳文件的詳細(xì)操作指南,需要的朋友可以參考下
一、核心概念
1. Django 文件字段
- ImageField：用于存儲(chǔ)圖片文件
- FileField：用于存儲(chǔ)任意文件類型
- upload_to：指定文件存儲(chǔ)的子目錄
2. 媒體文件系統(tǒng)
- MEDIA_ROOT：文件在服務(wù)器上的存儲(chǔ)路徑
- MEDIA_URL：文件訪問(wèn)的 URL 前綴
- 文件保存流程：
文件上傳 → 保存到 MEDIA_ROOT/upload_to/ → 數(shù)據(jù)庫(kù)記錄路徑
二、完整腳本示例
"""
Django 腳本上傳文件到 ImageField 完整示例
"""
import os
import sys
import django
from pathlib import Path
from django.core.files import File
import logging
# 配置日志
logger = logging.getLogger(__name__)
logging.basicConfig(
level=logging.INFO,
format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
handlers=[
logging.FileHandler('upload_script.log'),
logging.StreamHandler()
]
)
def setup_django():
"""配置 Django 環(huán)境"""
# 獲取項(xiàng)目根目錄
BASE_DIR = Path(__file__).resolve().parent.parent.parent
# 添加到系統(tǒng)路徑
sys.path.append(str(BASE_DIR))
# 設(shè)置 Django 環(huán)境變量
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'yunCoolCinema.settings')
# 初始化 Django
django.setup()
# 導(dǎo)入 Django 設(shè)置
from django.conf import settings
return settings
def upload_file_to_model(model, file_path, field_name='avatar', **kwargs):
"""
上傳文件到模型字段
:param model: 模型實(shí)例
:param file_path: 文件路徑
:param field_name: 字段名稱
:param kwargs: 模型過(guò)濾條件
:return: 更新后的模型實(shí)例
"""
# 獲取文件字段
file_field = getattr(model, field_name)
# 打開文件
with open(file_path, 'rb') as f:
# 保存文件到字段
file_field.save(
Path(file_path).name, # 文件名
File(f), # 文件內(nèi)容，轉(zhuǎn)換成django內(nèi)部的文件對(duì)象
save=True # 保存模型
)
logger.info('文件已上傳: %s -> %s', file_path, file_field.path)
return model
def main():
"""主函數(shù)"""
# 1. 設(shè)置 Django 環(huán)境
settings = setup_django()
logger.info('Django 環(huán)境設(shè)置完成')
# 2. 導(dǎo)入模型
from actors.models import Actor
# 3. 設(shè)置文件目錄
file_dir = Path('data/portrait') # 文件源目錄
if not file_dir.exists():
logger.error('文件目錄不存在: %s', file_dir)
return
# 4. 獲取演員和文件映射
# 假設(shè)文件名格式: {演員姓名}.jpg
file_map = {}
for file_path in file_dir.glob('*.*'):
if file_path.suffix.lower() in ['.jpg', '.jpeg', '.png']:
actor_name = file_path.stem # 文件名（不帶擴(kuò)展名）
file_map[actor_name] = file_path
# 5. 批量上傳文件
success_count = 0
for actor_name, file_path in file_map.items():
try:
# 獲取演員對(duì)象
actor = Actor.objects.get(name=actor_name)
# 上傳文件
upload_file_to_model(actor, file_path)
success_count += 1
except Actor.DoesNotExist:
logger.warning('演員不存在: %s', actor_name)
except Exception as e:
logger.error('上傳失敗: %s - %s', actor_name, str(e))
logger.info('文件上傳完成: 成功 %d 個(gè)', success_count)
if __name__ == "__main__":
main()
三、關(guān)鍵步驟詳解
1. 配置 Django 環(huán)境
def setup_django():
BASE_DIR = Path(__file__).resolve().parent.parent.parent
sys.path.append(str(BASE_DIR))
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'yunCoolCinema.settings')
django.setup()
from django.conf import settings
return settings
- 作用：使腳本能訪問(wèn) Django 模型和設(shè)置
- 注意：根據(jù)項(xiàng)目結(jié)構(gòu)調(diào)整路徑層級(jí)
2. 文件上傳核心函數(shù)
def upload_file_to_model(model, file_path, field_name='avatar', **kwargs):
file_field = getattr(model, field_name)
with open(file_path, 'rb') as f:
file_field.save(
Path(file_path).name, # 文件名
File(f), # 文件內(nèi)容
save=True # 保存模型
)
- 核心方法：
file_field.save() - 參數(shù)說(shuō)明：
- 第一個(gè)參數(shù)：保存的文件名
- 第二個(gè)參數(shù)：
File對(duì)象 save=True：自動(dòng)保存模型到數(shù)據(jù)庫(kù)
3. 路徑保存機(jī)制
# 上傳后文件保存位置 file_path = model.avatar.path # 物理路徑: MEDIA_ROOT/portrait/filename.jpg file_url = model.avatar.url # 訪問(wèn)URL: MEDIA_URL/portrait/filename.jpg
- 存儲(chǔ)位置：
MEDIA_ROOT/upload_to/filename - 自動(dòng)處理：Django 自動(dòng)處理文件存儲(chǔ)和路徑記錄
四、路徑保存注意事項(xiàng)
1. 正確配置 settings.py
# settings.py # 媒體文件配置 MEDIA_URL = '/media/' # 訪問(wèn)URL MEDIA_ROOT = os.path.join(BASE_DIR, 'media') # 文件存儲(chǔ)路徑
2. URL 配置
# urls.py
from django.conf import settings
from django.conf.urls.static import static
urlpatterns = [
# ...其他URL...
]
if settings.DEBUG:
urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
3. 文件名處理技巧
# 自定義文件名
def custom_filename(instance, filename):
"""生成自定義文件名"""
return f"portrait/{instance.id}_{filename}"
# 在模型中
avatar = models.ImageField(upload_to=custom_filename)
4. 避免路徑?jīng)_突
import uuid
def unique_filename(instance, filename):
"""生成唯一文件名"""
ext = filename.split('.')[-1]
return f"portrait/{uuid.uuid4().hex}.{ext}"
五、高級(jí)功能擴(kuò)展
1. 批量上傳優(yōu)化
def bulk_upload(models, file_map, field_name):
"""批量上傳文件"""
for model in models:
if model.name in file_map:
upload_file_to_model(model, file_map[model.name], field_name)
2. 添加進(jìn)度顯示
from tqdm import tqdm
# 在循環(huán)中使用
for actor_name, file_path in tqdm(file_map.items(), desc="上傳文件"):
# 上傳邏輯
3. 文件驗(yàn)證
from django.core.exceptions import ValidationError
def validate_image(file_path):
"""驗(yàn)證圖片文件"""
# 檢查文件大小
if file_path.stat().st_size > 5 * 1024 * 1024: # 5MB
raise ValidationError("文件大小超過(guò)限制")
# 檢查文件類型
if file_path.suffix.lower() not in ['.jpg', '.jpeg', '.png']:
raise ValidationError("不支持的文件類型")
4. 錯(cuò)誤處理增強(qiáng)
try:
upload_file_to_model(actor, file_path)
except OSError as e:
logger.error('文件操作錯(cuò)誤: %s', str(e))
except django.db.utils.IntegrityError as e:
logger.error('數(shù)據(jù)庫(kù)錯(cuò)誤: %s', str(e))
except Exception as e:
logger.exception('未知錯(cuò)誤')
六、生產(chǎn)環(huán)境最佳實(shí)踐
1. 使用云存儲(chǔ)
# settings.py DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage' AWS_ACCESS_KEY_ID = 'your-access-key' AWS_SECRET_ACCESS_KEY = 'your-secret-key' AWS_STORAGE_BUCKET_NAME = 'your-bucket-name' AWS_S3_REGION_NAME = 'your-region'
2. 添加文件清理
def cleanup_old_file(model, field_name):
"""清理舊文件"""
old_file = getattr(model, field_name)
if old_file and old_file.name:
old_file.delete(save=False) # 刪除文件但不保存模型
3. 使用緩存加速
from django.core.cache import cache
def get_cached_model(model_class, pk):
"""獲取緩存模型"""
cache_key = f"{model_class.__name__}_{pk}"
model = cache.get(cache_key)
if not model:
model = model_class.objects.get(pk=pk)
cache.set(cache_key, model, timeout=60 * 60) # 緩存1小時(shí)
return model
七、完整工作流程
1. 準(zhǔn)備環(huán)境
# 創(chuàng)建虛擬環(huán)境 python -m venv .venv source .venv/bin/activate # Linux/macOS .\.venv\Scripts\activate # Windows # 安裝依賴 pip install django tqdm
2. 文件目錄結(jié)構(gòu)
project/
├── manage.py
├── media/ # 上傳的文件存儲(chǔ)位置 (自動(dòng)創(chuàng)建)
├── data/ # 原始文件目錄
│ └── portrait/
│ ├── 張藝謀.jpg
│ └── 鞏俐.png
├── scripts/
│ └── upload_files.py # 上傳腳本
└── yunCoolCinema/
├── settings.py
├── urls.py
└── actors/
├── models.py
└── ...
3. 運(yùn)行腳本
python scripts/upload_files.py
4. 驗(yàn)證結(jié)果
# 在Django shell中驗(yàn)證 from actors.models import Actor actor = Actor.objects.get(name="張藝謀") print(actor.avatar.url) # 輸出: /media/portrait/張藝謀.jpg
八、常見(jiàn)問(wèn)題解答
Q1: 文件保存在哪里？
文件保存在 MEDIA_ROOT/upload_to/ 目錄下，其中：
MEDIA_ROOT在 settings.py 中定義upload_to在模型字段中定義
Q2: 如何訪問(wèn)上傳的文件？
在模板中使用：
<img src="{{ actor.avatar.url }}" alt="{{ actor.name }}">
確保在開發(fā)環(huán)境中配置了媒體文件服務(wù)。
Q3: 文件名沖突怎么辦？
- 使用
uuid生成唯一文件名 - 添加模型ID作為前綴
- 使用時(shí)間戳
Q4: 如何刪除舊文件？
# 更新文件時(shí)自動(dòng)刪除舊文件
def save(self, *args, **kwargs):
if self.pk: # 檢查是否是更新操作
old = Actor.objects.get(pk=self.pk)
if old.avatar != self.avatar: # 檢查頭像是否更改
old.avatar.delete(save=False) # 刪除舊文件
super().save(*args, **kwargs)
九、總結(jié)
通過(guò)本教程，您學(xué)會(huì)了：
- 如何配置 Django 腳本環(huán)境
- 如何通過(guò)腳本上傳文件到 ImageField
- 文件保存路徑的處理機(jī)制
- 生產(chǎn)環(huán)境的最佳實(shí)踐
關(guān)鍵點(diǎn)：
- 使用
file_field.save()方法上傳文件 - 確保
MEDIA_ROOT正確配置 - 文件將自動(dòng)保存到
MEDIA_ROOT/upload_to/目錄 - 數(shù)據(jù)庫(kù)記錄相對(duì)路徑（相對(duì)于
MEDIA_ROOT）
通過(guò)實(shí)現(xiàn)這些技術(shù)，您可以輕松地通過(guò)腳本將文件上傳到 Django 的 ImageField 字段，并確保文件保存在正確的位置。
以上就是Django通過(guò)腳本上傳文件的詳細(xì)操作指南的詳細(xì)內(nèi)容，更多關(guān)于Django腳本上傳文件的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
這篇文章主要為大家詳細(xì)介紹了Python進(jìn)程間通信，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下，希望能夠給你帶來(lái)幫助2022-03-03
下面小編就為大家?guī)?lái)一篇使用Python文件操作之二進(jìn)制文件。小編覺(jué)得挺不錯(cuò)的，現(xiàn)在就分享給大家，也給大家做個(gè)參考。一起跟隨小編過(guò)來(lái)看看吧2021-09-09
Python+Pygame實(shí)現(xiàn)之走四棋兒游戲的實(shí)現(xiàn)
大家以前應(yīng)該都聽說(shuō)過(guò)一個(gè)游戲：叫做走四棋兒。直接在家里的水泥地上用燒完的炭火灰畫出幾條線，擺上幾顆石頭子即可。當(dāng)時(shí)的火爆程度可謂是達(dá)到了一個(gè)新的高度。本文將利用Pygame實(shí)現(xiàn)這一游戲，需要的可以參考一下2022-07-07
Pydantic中model_validator的實(shí)現(xiàn)
本文主要介紹了Pydantic中model_validator的實(shí)現(xiàn),文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2025-04-04
一個(gè)小示例告訴你Python語(yǔ)言的優(yōu)雅之處
本篇中, 我們展示一下一段非常小的代碼, 這段代碼十分吸引我們, 因?yàn)樗褂檬謨?yōu)雅和直接的方式解決了一個(gè)常見(jiàn)的問(wèn)題.2014-07-07
Python?pip安裝庫(kù)時(shí)存在緩存以及清除方法
這篇文章主要給大家介紹了關(guān)于Python?pip安裝庫(kù)時(shí)存在緩存以及清除方法的相關(guān)資料,我們?cè)诎惭bPython庫(kù)時(shí),是安裝版的話一般都通過(guò)?pip?install?xxx?來(lái)安裝包,但安裝下載的文件都會(huì)緩存下來(lái),而且一般都在C盤,需要的朋友可以參考下2023-08-08
這篇文章主要為大家介紹了Python文件操作，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下，希望能夠給你帶來(lái)幫助<BR>2021-11-11
利用Python多處理庫(kù)處理3D數(shù)據(jù)詳解
本文將介紹處理大量數(shù)據(jù)時(shí)非常方便的工具，例如tqdm與 multiprocessing?imap??一起使用、并行處理檔案、繪制和處理3D數(shù)據(jù)等，感興趣的小伙伴可以了解一下2021-12-12
langchain中的chat?models介紹和使用實(shí)例
這篇文章主要介紹了langchain中的chat?models介紹和使用實(shí)例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2023-11-11
python實(shí)現(xiàn)圖像自動(dòng)Gamma校正方式
這篇文章主要介紹了python實(shí)現(xiàn)圖像自動(dòng)Gamma校正方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2023-10-10