简介这是一套面向软件工程专业本科生的毕业设计级Django Web应用源码聚焦高校学生宿舍管理场景解决宿舍分配、床位调整、报修登记、卫生检查等实际业务需求。资源包含2000个文件主体为1337个Python后端逻辑文件含Models、Views、Forms及Admin配置、344个HTML模板页与225个JavaScript交互脚本辅以49个CSS样式文件含Bootstrap、Font Awesome、Select2等主流前端库整体压缩包17.46MB结构完整、模块清晰覆盖Web开发全链路实践。已有115人学习下载适合初学者系统掌握Django MVC架构、用户权限控制、数据库CRUD操作及前后端协同开发流程。源码附带完整可运行项目结构、标准化URL路由配置、内置Admin后台与响应式前端界面开箱即用便于二次开发与课程答辩演示。1. 这不是又一个“增删改查”DemoDjango宿舍系统源码里藏着软件工程毕业设计的完整闭环你下载到的这个基于django的学生宿舍管理系统python源码.zip表面看是套带 Bootstrap 和 Font Awesome 的 CRUD 页面但真正价值在于它把软件工程专业毕业设计最常卡壳的五个断点——需求落地难、权限分层虚、数据一致性弱、部署路径模糊、测试无从下手——全用可运行代码填平了。它没用 Vue 或 React 做前后端分离而是扎实走通 Django 原生 MTVModel-Template-View全流程从models.py里Student和Dormitory两个模型的外键约束设计到admin.py中对DormitoryAllocation模型启用list_editable实现床位批量调整从views.py中用LoginRequiredMixin控制普通学生仅能访问/my-dorm/到settings.py里AUTH_PASSWORD_VALIDATORS配置强制密码含数字大小写字母。这不是教学演示项目而是高校信息中心真实验收过、带migrations/0003_auto_20230517_1422.py这类带时间戳迁移文件的生产级骨架。如果你正为毕设开题被导师质疑“业务逻辑太单薄”发愁或卡在“怎么让管理员和学生看到不同数据视图”上这份源码就是你缺的那张施工蓝图。2. 从 models.py 到数据库宿舍管理核心实体的 Django ORM 实现与约束设计2.1 宿舍管理三大核心模型的字段语义与关系建模源码中models.py定义了三个关键模型Building宿舍楼、Dormitory宿舍房间和Student学生它们通过外键形成树状结构。这种设计直接对应高校宿舍管理的实际组织逻辑——一栋楼有多个房间一个房间住多名学生而学生学号是全局唯一标识。关键字段如下表所示模型字段名类型约束说明业务含义BuildingcodeCharField(max_length10)uniqueTrue宿舍楼编号如“东1栋”作为URL路由参数和前端筛选依据Dormitoryroom_numberCharField(max_length8)unique_for_datebuilding房间号如“301”在同栋楼内唯一避免跨楼重复Studentbed_positionCharField(max_length3)choices[(A,上铺),(B,下铺)]床位物理位置非数字编号规避“第3个床位”在双层床场景下的歧义提示unique_for_date是 Django 特有约束此处实际应为unique_together (building, room_number)。源码中若存在笔误需在Dormitory模型 Meta 类中修正否则迁移时会报FieldError。2.2 外键关联与级联行为的显式声明Dormitory模型通过building models.ForeignKey(Building, on_deletemodels.PROTECT)关联宿舍楼。这里on_deletemodels.PROTECT是关键设计当管理员试图删除一栋已分配房间的宿舍楼时Django 会抛出ProtectedError异常而非静默级联删除强制操作者先清空该楼所有房间记录。这比默认的CASCADE更符合高校资产管理规范——删除楼栋必须走审批流程不能由后台操作一键触发。同样Student模型中dormitory models.ForeignKey(Dormitory, on_deletemodels.SET_NULL, nullTrue)设置为SET_NULL意味着学生退宿后其dormitory字段置空但学生记录本身保留。这保证了历史住宿记录可追溯避免因CASCADE导致学生档案丢失。2.3 迁移文件生成与数据库同步实操执行以下命令完成模型到数据库的映射# 生成迁移文件检查输出是否包含新增字段 python manage.py makemigrations # 查看将要执行的SQL关键确认外键约束是否正确 python manage.py sqlmigrate dorm_management 0001 # 同步到数据库假设使用SQLite默认db.sqlite3 python manage.py migratesqlmigrate命令输出中应出现类似FOREIGN KEY (building_id) REFERENCES dorm_management_building (id) DEFERRABLE INITIALLY DEFERRED的语句证明外键已正确创建。若未出现需检查models.py中ForeignKey参数拼写如误写为on_delelte。2.4 Admin 后台的定制化配置与权限隔离admin.py文件中对DormitoryAdmin类的配置体现了权限分层思想class DormitoryAdmin(admin.ModelAdmin): list_display (room_number, building, capacity, occupied_count) list_filter (building, capacity) # 右侧筛选栏按楼栋和容量过滤 search_fields (room_number,) # 顶部搜索框支持房间号模糊查询 readonly_fields (occupied_count,) # 床位占用数只读由get_occupied_count方法计算 def occupied_count(self, obj): return obj.student_set.count() # 动态计算当前入住人数 occupied_count.short_description 已住人数此处readonly_fields将occupied_count设为只读避免人工误填list_filter和search_fields则让管理员在百间宿舍中快速定位目标。更重要的是list_display中的occupied_count方法调用obj.student_set.count()利用 Django 的反向关系自动关联Student模型无需手写 SQL JOIN。3. 用户角色与权限控制从 LoginRequiredMixin 到自定义权限组的实战配置3.1 基于 Django 内置认证系统的角色划分逻辑源码未使用第三方权限库而是依托 Django 原生User模型和Group机制实现角色控制。系统预设两个权限组dorm_admin组拥有add_dormitory,change_dormitory,delete_dormitory权限对应宿舍分配、调整、退宿等操作student_user组仅拥有view_student权限且只能查看自身记录。这种设计规避了为每个学生单独授权的复杂性转而通过Group批量赋权。关键验证逻辑在views.py的MyDormView中from django.contrib.auth.mixins import LoginRequiredMixin, UserPassesTestMixin class MyDormView(LoginRequiredMixin, UserPassesTestMixin, TemplateView): template_name dorm/my_dorm.html def test_func(self): # 仅允许学生用户访问且只能查看自己的宿舍信息 return self.request.user.groups.filter(namestudent_user).exists() def get_context_data(self, **kwargs): context super().get_context_data(**kwargs) # 通过 user.student_set 获取该学生关联的宿舍一对多反向查询 student self.request.user.student_set.first() if student and student.dormitory: context[dorm] student.dormitory context[bed] student.bed_position return contextUserPassesTestMixin的test_func方法在每次请求前校验用户是否属于student_user组get_context_data则通过self.request.user.student_set.first()获取当前登录用户的学生档案再通过student.dormitory关联到宿舍对象。整个过程不依赖 session 存储完全基于数据库关系实时查询。3.2 权限组的初始化与用户分配脚本首次部署时需创建权限组并分配用户。源码中management/commands/init_permissions.py提供了自动化脚本# management/commands/init_permissions.py from django.core.management.base import BaseCommand from django.contrib.auth.models import Group, Permission from django.contrib.contenttypes.models import ContentType from dorm_management.models import Dormitory, Student class Command(BaseCommand): def handle(self, *args, **options): # 创建 dorm_admin 组 admin_group, _ Group.objects.get_or_create(namedorm_admin) # 获取 Dormitory 模型的 content_type dorm_content_type ContentType.objects.get_for_model(Dormitory) # 分配 add/change/delete 权限 permissions Permission.objects.filter( content_typedorm_content_type, codename__in[add_dormitory, change_dormitory, delete_dormitory] ) admin_group.permissions.set(permissions) # 创建 student_user 组 student_group, _ Group.objects.get_or_create(namestudent_user) student_content_type ContentType.objects.get_for_model(Student) view_perm Permission.objects.get( content_typestudent_content_type, codenameview_student ) student_group.permissions.add(view_perm)执行python manage.py init_permissions即可完成初始化。注意此脚本需在migrate之后运行否则ContentType查询会失败。3.3 URL 路由的权限感知设计urls.py中的路由配置与视图权限严格绑定# urls.py from django.urls import path from . import views urlpatterns [ path(admin/, admin.site.urls), # Django 默认admin供超级管理员使用 path(login/, auth_views.LoginView.as_view(template_nameregistration/login.html), namelogin), path(logout/, auth_views.LogoutView.as_view(), namelogout), path(my-dorm/, views.MyDormView.as_view(), namemy_dorm), # 学生专属入口 path(dorm-list/, views.DormitoryListView.as_view(), namedorm_list), # 管理员列表页 ]my-dorm/路径仅对student_user组开放而dorm-list/路径在对应视图中需额外添加UserPassesTestMixin校验dorm_admin组。这种 URL 层面的隔离配合模板中{% if perms.dorm_management.change_dormitory %}的条件渲染构成双重防护。4. 前端交互与响应式实现Bootstrap 4 Select2 在 Django 表单中的深度集成4.1 Select2 下拉选择器在宿舍分配表单中的应用源码中templates/dorm/allocate_form.html使用 Select2 替代原生select解决宿舍楼-房间二级联动问题。关键 HTML 结构如下!-- 宿舍楼选择 -- select idid_building namebuilding classform-control select2 {% for building in buildings %} option value{{ building.id }}{{ building.code }}/option {% endfor %} /select !-- 房间选择初始为空由JS动态填充 -- select idid_dormitory namedormitory classform-control select2 disabled option value请选择房间/option /select配套 JavaScript 代码位于static/js/allocate.js监听楼栋选择变化$(#id_building).on(change, function() { const buildingId $(this).val(); if (!buildingId) { $(#id_dormitory).prop(disabled, true).empty().append(option value请选择房间/option); return; } // AJAX 请求获取该楼栋下的房间列表 $.get(/api/dormitories/?building${buildingId}, function(data) { const $dormSelect $(#id_dormitory); $dormSelect.empty().prop(disabled, false); $.each(data, function(i, dorm) { $dormSelect.append(option value${dorm.id}${dorm.room_number}/option); }); $dormSelect.select2(destroy).select2(); // 重新初始化Select2 }); });注意/api/dormitories/是自定义 API 视图返回 JSON 格式房间列表非 Django REST Framework 实现轻量且满足需求。4.2 Bootstrap 4 表格与响应式断点的实际运用templates/dorm/dorm_list.html中的宿舍列表采用 Bootstrap 4 的.table-responsive类div classtable-responsive table classtable table-striped table-hover thead classthead-dark tr th scopecol房间号/th th scopecol所在楼栋/th th scopecol容量/th th scopecol已住/th th scopecol操作/th /tr /thead tbody {% for dorm in dorms %} tr td{{ dorm.room_number }}/td td{{ dorm.building.code }}/td td{{ dorm.capacity }}/td td{{ dorm.occupied_count }}/td td a href{% url dorm_detail dorm.id %} classbtn btn-sm btn-info详情/a {% if perms.dorm_management.change_dormitory %} a href{% url dorm_edit dorm.id %} classbtn btn-sm btn-warning编辑/a {% endif %} /td /tr {% endfor %} /tbody /table /div.table-responsive在屏幕宽度小于768pxsm断点时自动添加水平滚动条确保小屏设备上表格内容不被截断。btn-sm类缩小按钮尺寸适配移动端点击区域。4.3 Font Awesome 图标在状态提示中的语义化表达源码中大量使用 Font Awesome 图标传递状态信息例如在templates/dorm/my_dorm.html中div classalert alert-success i classfas fa-bed fa-lg mr-2/i 您当前入住 {{ dorm.building.code }} {{ dorm.room_number }}床位{{ bed }} /divfas fa-bed直观表示宿舍床位mr-2margin-right: 0.5rem提供图标与文字间距。这种语义化图标比纯文字更易识别且fa-lg类确保在高分辨率屏幕上清晰显示。5. 部署与调试从 SQLite 开发环境到 Linux 生产环境的平滑迁移5.1 settings.py 的环境变量驱动配置源码采用django-environ库实现配置分离在settings/base.py中import environ env environ.Env( DEBUG(bool, False), DATABASE_URL(str, sqlite:///db.sqlite3), SECRET_KEY(str, dev-secret-key-change-in-prod), ) DEBUG env(DEBUG) SECRET_KEY env(SECRET_KEY) # 数据库配置自动解析 DATABASES { default: env.db(), }开发时.env文件内容为DEBUGTrue DATABASE_URLsqlite:///db.sqlite3 SECRET_KEYyour-dev-secret-key生产环境则改为DEBUGFalse DATABASE_URLpostgres://user:passwordlocalhost:5432/dorm_db SECRET_KEYyour-prod-secret-key执行pip install django-environ后env.db()自动识别postgres://前缀并配置 PostgreSQL 连接无需修改代码。5.2 Gunicorn Nginx 部署的关键配置项Linux 生产部署需配置 Gunicorn 作为应用服务器Nginx 作为反向代理。Gunicorn 启动命令示例# 在项目根目录执行 gunicorn --bind 127.0.0.1:8000 --workers 3 --access-logfile - --error-logfile - dorm_management.wsgi:applicationNginx 配置片段/etc/nginx/sites-available/dormserver { listen 80; server_name dorm.example.com; location /static/ { alias /var/www/dorm/staticfiles/; # collectstatic 输出目录 } location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }提示collectstatic命令必须在部署前执行将static/下所有 CSS/JS 文件收集到staticfiles/目录供 Nginx 直接服务避免 Django 处理静态文件拖慢响应。5.3 Django Debug Toolbar 的本地调试技巧开发阶段启用django-debug-toolbar可直观查看 SQL 查询、模板渲染耗时。在settings/dev.py中添加INSTALLED_APPS [debug_toolbar] MIDDLEWARE [debug_toolbar.middleware.DebugToolbarMiddleware] INTERNAL_IPS [127.0.0.1] # 仅对本地IP显示工具栏启动开发服务器后页面右下角会出现调试面板。点击 “SQL” 标签页可发现MyDormView中student.dormitory查询是否触发了 N1 问题——若显示多条SELECT ... FROM dorm_management_dormitory需在get_context_data中改用select_related(dormitory)优化student self.request.user.student_set.select_related(dormitory).first()此优化将原本 2 次查询查 student 查 dormitory合并为 1 次 JOIN 查询显著提升性能。本文还有配套的精品资源点击获取 Django宿舍管理系统：毕业设计全流程实战指南
简介这是一套面向软件工程专业本科生的毕业设计级Django Web应用源码聚焦高校学生宿舍管理场景解决宿舍分配、床位调整、报修登记、卫生检查等实际业务需求。资源包含2000个文件主体为1337个Python后端逻辑文件含Models、Views、Forms及Admin配置、344个HTML模板页与225个JavaScript交互脚本辅以49个CSS样式文件含Bootstrap、Font Awesome、Select2等主流前端库整体压缩包17.46MB结构完整、模块清晰覆盖Web开发全链路实践。已有115人学习下载适合初学者系统掌握Django MVC架构、用户权限控制、数据库CRUD操作及前后端协同开发流程。源码附带完整可运行项目结构、标准化URL路由配置、内置Admin后台与响应式前端界面开箱即用便于二次开发与课程答辩演示。1. 这不是又一个“增删改查”DemoDjango宿舍系统源码里藏着软件工程毕业设计的完整闭环你下载到的这个基于django的学生宿舍管理系统python源码.zip表面看是套带 Bootstrap 和 Font Awesome 的 CRUD 页面但真正价值在于它把软件工程专业毕业设计最常卡壳的五个断点——需求落地难、权限分层虚、数据一致性弱、部署路径模糊、测试无从下手——全用可运行代码填平了。它没用 Vue 或 React 做前后端分离而是扎实走通 Django 原生 MTVModel-Template-View全流程从models.py里Student和Dormitory两个模型的外键约束设计到admin.py中对DormitoryAllocation模型启用list_editable实现床位批量调整从views.py中用LoginRequiredMixin控制普通学生仅能访问/my-dorm/到settings.py里AUTH_PASSWORD_VALIDATORS配置强制密码含数字大小写字母。这不是教学演示项目而是高校信息中心真实验收过、带migrations/0003_auto_20230517_1422.py这类带时间戳迁移文件的生产级骨架。如果你正为毕设开题被导师质疑“业务逻辑太单薄”发愁或卡在“怎么让管理员和学生看到不同数据视图”上这份源码就是你缺的那张施工蓝图。2. 从 models.py 到数据库宿舍管理核心实体的 Django ORM 实现与约束设计2.1 宿舍管理三大核心模型的字段语义与关系建模源码中models.py定义了三个关键模型Building宿舍楼、Dormitory宿舍房间和Student学生它们通过外键形成树状结构。这种设计直接对应高校宿舍管理的实际组织逻辑——一栋楼有多个房间一个房间住多名学生而学生学号是全局唯一标识。关键字段如下表所示模型字段名类型约束说明业务含义BuildingcodeCharField(max_length10)uniqueTrue宿舍楼编号如“东1栋”作为URL路由参数和前端筛选依据Dormitoryroom_numberCharField(max_length8)unique_for_datebuilding房间号如“301”在同栋楼内唯一避免跨楼重复Studentbed_positionCharField(max_length3)choices[(A,上铺),(B,下铺)]床位物理位置非数字编号规避“第3个床位”在双层床场景下的歧义提示unique_for_date是 Django 特有约束此处实际应为unique_together (building, room_number)。源码中若存在笔误需在Dormitory模型 Meta 类中修正否则迁移时会报FieldError。2.2 外键关联与级联行为的显式声明Dormitory模型通过building models.ForeignKey(Building, on_deletemodels.PROTECT)关联宿舍楼。这里on_deletemodels.PROTECT是关键设计当管理员试图删除一栋已分配房间的宿舍楼时Django 会抛出ProtectedError异常而非静默级联删除强制操作者先清空该楼所有房间记录。这比默认的CASCADE更符合高校资产管理规范——删除楼栋必须走审批流程不能由后台操作一键触发。同样Student模型中dormitory models.ForeignKey(Dormitory, on_deletemodels.SET_NULL, nullTrue)设置为SET_NULL意味着学生退宿后其dormitory字段置空但学生记录本身保留。这保证了历史住宿记录可追溯避免因CASCADE导致学生档案丢失。2.3 迁移文件生成与数据库同步实操执行以下命令完成模型到数据库的映射# 生成迁移文件检查输出是否包含新增字段 python manage.py makemigrations # 查看将要执行的SQL关键确认外键约束是否正确 python manage.py sqlmigrate dorm_management 0001 # 同步到数据库假设使用SQLite默认db.sqlite3 python manage.py migratesqlmigrate命令输出中应出现类似FOREIGN KEY (building_id) REFERENCES dorm_management_building (id) DEFERRABLE INITIALLY DEFERRED的语句证明外键已正确创建。若未出现需检查models.py中ForeignKey参数拼写如误写为on_delelte。2.4 Admin 后台的定制化配置与权限隔离admin.py文件中对DormitoryAdmin类的配置体现了权限分层思想class DormitoryAdmin(admin.ModelAdmin): list_display (room_number, building, capacity, occupied_count) list_filter (building, capacity) # 右侧筛选栏按楼栋和容量过滤 search_fields (room_number,) # 顶部搜索框支持房间号模糊查询 readonly_fields (occupied_count,) # 床位占用数只读由get_occupied_count方法计算 def occupied_count(self, obj): return obj.student_set.count() # 动态计算当前入住人数 occupied_count.short_description 已住人数此处readonly_fields将occupied_count设为只读避免人工误填list_filter和search_fields则让管理员在百间宿舍中快速定位目标。更重要的是list_display中的occupied_count方法调用obj.student_set.count()利用 Django 的反向关系自动关联Student模型无需手写 SQL JOIN。3. 用户角色与权限控制从 LoginRequiredMixin 到自定义权限组的实战配置3.1 基于 Django 内置认证系统的角色划分逻辑源码未使用第三方权限库而是依托 Django 原生User模型和Group机制实现角色控制。系统预设两个权限组dorm_admin组拥有add_dormitory,change_dormitory,delete_dormitory权限对应宿舍分配、调整、退宿等操作student_user组仅拥有view_student权限且只能查看自身记录。这种设计规避了为每个学生单独授权的复杂性转而通过Group批量赋权。关键验证逻辑在views.py的MyDormView中from django.contrib.auth.mixins import LoginRequiredMixin, UserPassesTestMixin class MyDormView(LoginRequiredMixin, UserPassesTestMixin, TemplateView): template_name dorm/my_dorm.html def test_func(self): # 仅允许学生用户访问且只能查看自己的宿舍信息 return self.request.user.groups.filter(namestudent_user).exists() def get_context_data(self, **kwargs): context super().get_context_data(**kwargs) # 通过 user.student_set 获取该学生关联的宿舍一对多反向查询 student self.request.user.student_set.first() if student and student.dormitory: context[dorm] student.dormitory context[bed] student.bed_position return contextUserPassesTestMixin的test_func方法在每次请求前校验用户是否属于student_user组get_context_data则通过self.request.user.student_set.first()获取当前登录用户的学生档案再通过student.dormitory关联到宿舍对象。整个过程不依赖 session 存储完全基于数据库关系实时查询。3.2 权限组的初始化与用户分配脚本首次部署时需创建权限组并分配用户。源码中management/commands/init_permissions.py提供了自动化脚本# management/commands/init_permissions.py from django.core.management.base import BaseCommand from django.contrib.auth.models import Group, Permission from django.contrib.contenttypes.models import ContentType from dorm_management.models import Dormitory, Student class Command(BaseCommand): def handle(self, *args, **options): # 创建 dorm_admin 组 admin_group, _ Group.objects.get_or_create(namedorm_admin) # 获取 Dormitory 模型的 content_type dorm_content_type ContentType.objects.get_for_model(Dormitory) # 分配 add/change/delete 权限 permissions Permission.objects.filter( content_typedorm_content_type, codename__in[add_dormitory, change_dormitory, delete_dormitory] ) admin_group.permissions.set(permissions) # 创建 student_user 组 student_group, _ Group.objects.get_or_create(namestudent_user) student_content_type ContentType.objects.get_for_model(Student) view_perm Permission.objects.get( content_typestudent_content_type, codenameview_student ) student_group.permissions.add(view_perm)执行python manage.py init_permissions即可完成初始化。注意此脚本需在migrate之后运行否则ContentType查询会失败。3.3 URL 路由的权限感知设计urls.py中的路由配置与视图权限严格绑定# urls.py from django.urls import path from . import views urlpatterns [ path(admin/, admin.site.urls), # Django 默认admin供超级管理员使用 path(login/, auth_views.LoginView.as_view(template_nameregistration/login.html), namelogin), path(logout/, auth_views.LogoutView.as_view(), namelogout), path(my-dorm/, views.MyDormView.as_view(), namemy_dorm), # 学生专属入口 path(dorm-list/, views.DormitoryListView.as_view(), namedorm_list), # 管理员列表页 ]my-dorm/路径仅对student_user组开放而dorm-list/路径在对应视图中需额外添加UserPassesTestMixin校验dorm_admin组。这种 URL 层面的隔离配合模板中{% if perms.dorm_management.change_dormitory %}的条件渲染构成双重防护。4. 前端交互与响应式实现Bootstrap 4 Select2 在 Django 表单中的深度集成4.1 Select2 下拉选择器在宿舍分配表单中的应用源码中templates/dorm/allocate_form.html使用 Select2 替代原生select解决宿舍楼-房间二级联动问题。关键 HTML 结构如下!-- 宿舍楼选择 -- select idid_building namebuilding classform-control select2 {% for building in buildings %} option value{{ building.id }}{{ building.code }}/option {% endfor %} /select !-- 房间选择初始为空由JS动态填充 -- select idid_dormitory namedormitory classform-control select2 disabled option value请选择房间/option /select配套 JavaScript 代码位于static/js/allocate.js监听楼栋选择变化$(#id_building).on(change, function() { const buildingId $(this).val(); if (!buildingId) { $(#id_dormitory).prop(disabled, true).empty().append(option value请选择房间/option); return; } // AJAX 请求获取该楼栋下的房间列表 $.get(/api/dormitories/?building${buildingId}, function(data) { const $dormSelect $(#id_dormitory); $dormSelect.empty().prop(disabled, false); $.each(data, function(i, dorm) { $dormSelect.append(option value${dorm.id}${dorm.room_number}/option); }); $dormSelect.select2(destroy).select2(); // 重新初始化Select2 }); });注意/api/dormitories/是自定义 API 视图返回 JSON 格式房间列表非 Django REST Framework 实现轻量且满足需求。4.2 Bootstrap 4 表格与响应式断点的实际运用templates/dorm/dorm_list.html中的宿舍列表采用 Bootstrap 4 的.table-responsive类div classtable-responsive table classtable table-striped table-hover thead classthead-dark tr th scopecol房间号/th th scopecol所在楼栋/th th scopecol容量/th th scopecol已住/th th scopecol操作/th /tr /thead tbody {% for dorm in dorms %} tr td{{ dorm.room_number }}/td td{{ dorm.building.code }}/td td{{ dorm.capacity }}/td td{{ dorm.occupied_count }}/td td a href{% url dorm_detail dorm.id %} classbtn btn-sm btn-info详情/a {% if perms.dorm_management.change_dormitory %} a href{% url dorm_edit dorm.id %} classbtn btn-sm btn-warning编辑/a {% endif %} /td /tr {% endfor %} /tbody /table /div.table-responsive在屏幕宽度小于768pxsm断点时自动添加水平滚动条确保小屏设备上表格内容不被截断。btn-sm类缩小按钮尺寸适配移动端点击区域。4.3 Font Awesome 图标在状态提示中的语义化表达源码中大量使用 Font Awesome 图标传递状态信息例如在templates/dorm/my_dorm.html中div classalert alert-success i classfas fa-bed fa-lg mr-2/i 您当前入住 {{ dorm.building.code }} {{ dorm.room_number }}床位{{ bed }} /divfas fa-bed直观表示宿舍床位mr-2margin-right: 0.5rem提供图标与文字间距。这种语义化图标比纯文字更易识别且fa-lg类确保在高分辨率屏幕上清晰显示。5. 部署与调试从 SQLite 开发环境到 Linux 生产环境的平滑迁移5.1 settings.py 的环境变量驱动配置源码采用django-environ库实现配置分离在settings/base.py中import environ env environ.Env( DEBUG(bool, False), DATABASE_URL(str, sqlite:///db.sqlite3), SECRET_KEY(str, dev-secret-key-change-in-prod), ) DEBUG env(DEBUG) SECRET_KEY env(SECRET_KEY) # 数据库配置自动解析 DATABASES { default: env.db(), }开发时.env文件内容为DEBUGTrue DATABASE_URLsqlite:///db.sqlite3 SECRET_KEYyour-dev-secret-key生产环境则改为DEBUGFalse DATABASE_URLpostgres://user:passwordlocalhost:5432/dorm_db SECRET_KEYyour-prod-secret-key执行pip install django-environ后env.db()自动识别postgres://前缀并配置 PostgreSQL 连接无需修改代码。5.2 Gunicorn Nginx 部署的关键配置项Linux 生产部署需配置 Gunicorn 作为应用服务器Nginx 作为反向代理。Gunicorn 启动命令示例# 在项目根目录执行 gunicorn --bind 127.0.0.1:8000 --workers 3 --access-logfile - --error-logfile - dorm_management.wsgi:applicationNginx 配置片段/etc/nginx/sites-available/dormserver { listen 80; server_name dorm.example.com; location /static/ { alias /var/www/dorm/staticfiles/; # collectstatic 输出目录 } location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }提示collectstatic命令必须在部署前执行将static/下所有 CSS/JS 文件收集到staticfiles/目录供 Nginx 直接服务避免 Django 处理静态文件拖慢响应。5.3 Django Debug Toolbar 的本地调试技巧开发阶段启用django-debug-toolbar可直观查看 SQL 查询、模板渲染耗时。在settings/dev.py中添加INSTALLED_APPS [debug_toolbar] MIDDLEWARE [debug_toolbar.middleware.DebugToolbarMiddleware] INTERNAL_IPS [127.0.0.1] # 仅对本地IP显示工具栏启动开发服务器后页面右下角会出现调试面板。点击 “SQL” 标签页可发现MyDormView中student.dormitory查询是否触发了 N1 问题——若显示多条SELECT ... FROM dorm_management_dormitory需在get_context_data中改用select_related(dormitory)优化student self.request.user.student_set.select_related(dormitory).first()此优化将原本 2 次查询查 student 查 dormitory合并为 1 次 JOIN 查询显著提升性能。本文还有配套的精品资源点击获取