在Web项目开发中，实现Excel、DOCX和PDF文件在浏览器中直接预览，能够显著提升用户的使用体验，减少文件下载和本地打开的操作步骤。我们可以通过Django作为后端框架，搭配Python的各类文档处理库来完成这个功能。
环境准备
首先需要安装对应的Python依赖库，不同文件类型需要不同的处理库：
- 处理Excel文件：
openpyxl、pandas - 处理DOCX文件：
python-docx、mammoth - 处理PDF文件：
PyPDF2、pdfplumber - Django相关：
django
使用pip命令安装依赖：
pip install django openpyxl pandas python-docx mammoth PyPDF2 pdfplumber
Excel文件预览实现
Excel文件的预览思路是读取文件内容后转换为HTML表格，再返回给前端渲染。首先在Django中创建对应的视图函数：
import pandas as pd
from django.http import HttpResponse
from django.conf import settings
import os
def preview_excel(request, file_name):
# 拼接文件路径，假设文件存储在项目的media/excel目录下
file_path = os.path.join(settings.MEDIA_ROOT, 'excel', file_name)
try:
# 读取Excel文件，默认读取第一个工作表
df = pd.read_excel(file_path)
# 将DataFrame转换为HTML表格
table_html = df.to_html(classes='excel-table', index=False)
# 拼接完整的HTML页面返回
html_content = f'''
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Excel预览</title>
<style>
.excel-table {{
border-collapse: collapse;
width: 100%;
margin: 20px 0;
}}
.excel-table th, .excel-table td {{
border: 1px solid #ddd;
padding: 8px;
text-align: left;
}}
.excel-table th {{
background-color: #f2f2f2;
}}
</style>
</head>
<body>
<h2>{file_name} 预览</h2>
{table_html}
</body>
</html>
'''
return HttpResponse(html_content)
except Exception as e:
return HttpResponse(f'文件预览失败：{str(e)}', status=500)
DOCX文件预览实现
DOCX文件可以使用mammoth库将文档内容转换为HTML，保留基本的格式样式。对应的视图函数如下：
import mammoth
from django.http import HttpResponse
from django.conf import settings
import os
def preview_docx(request, file_name):
file_path = os.path.join(settings.MEDIA_ROOT, 'docx', file_name)
try:
with open(file_path, 'rb') as docx_file:
# 将DOCX转换为HTML
result = mammoth.convert_to_html(docx_file)
html_content = result.value
# 拼接页面返回
full_html = f'''
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>DOCX预览</title>
<style>
body {{
max-width: 800px;
margin: 0 auto;
padding: 20px;
line-height: 1.6;
}}
</style>
</head>
<body>
<h2>{file_name} 预览</h2>
{html_content}
</body>
</html>
'''
return HttpResponse(full_html)
except Exception as e:
return HttpResponse(f'文件预览失败：{str(e)}', status=500)
PDF文件预览实现
PDF文件的预览可以直接返回PDF文件流，让浏览器自带的PDF阅读器渲染，也可以提取文本内容展示。这里采用返回文件流的方式，兼容性更好：
from django.http import FileResponse
from django.conf import settings
import os
def preview_pdf(request, file_name):
file_path = os.path.join(settings.MEDIA_ROOT, 'pdf', file_name)
try:
# 打开PDF文件，返回文件响应，设置Content-Type为application/pdf
response = FileResponse(open(file_path, 'rb'), content_type='application/pdf')
# 设置inline参数，让浏览器内联显示而不是下载
response['Content-Disposition'] = f'inline; filename="{file_name}"'
return response
except Exception as e:
return HttpResponse(f'文件预览失败：{str(e)}', status=500)
路由配置
在Django的urls.py中添加对应的路由规则：
from django.urls import path
from . import views
urlpatterns = [
path('preview/excel/<str:file_name>/', views.preview_excel, name='preview_excel'),
path('preview/docx/<str:file_name>/', views.preview_docx, name='preview_docx'),
path('preview/pdf/<str:file_name>/', views.preview_pdf, name='preview_pdf'),
]
注意事项
- 需要确保Django的
MEDIA_ROOT配置正确，文件存储路径和视图中拼接的路径一致 - 实际项目中需要添加文件存在性校验、用户权限校验等逻辑，避免未授权访问
- 如果Excel文件包含多个工作表，可以扩展视图函数支持工作表切换
- DOCX转换的HTML样式可以根据需求自定义调整CSS
DjangoPythonExcel_previewDOCX_previewPDF_preview修改时间：2026-06-15 21:27:22