本项目是基于 Python Flask 和 SQLite 开发的学生宿舍管理系统包含学生、楼栋、房间、床位、入住、水电、报修、访客及卫生检查等功能并提供管理员、宿管和学生三类角色权限帮助学校更高效地管理宿舍日常业务。演示账号学生student / student123 宿管manager / manager123 管理员admin / admin123上述账号需要使用项目自带的演示数据库或者执行过python -m flask --app dormitory_manager seed-demo。seed-demo会清空原有数据请勿在正式数据环境中执行。公开部署后请立即修改这些默认密码。一、先了解几个概念项目目录包含run.py、requirements.txt、dormitory_manager文件夹的目录。命令行/终端本文 Windows 环境使用 PowerShellUbuntu 使用终端。虚拟环境.venv项目专用的 Python 环境避免不同项目的依赖互相冲突。SQLite 数据库本项目的数据保存在项目目录下的dormitory.db文件中不需要另外安装 MySQL。IP 和端口本项目默认使用5000端口本机访问地址通常是http://127.0.0.1:5000。项目关键文件如下学生宿舍管理系统/ ├─ run.py # 程序启动入口 ├─ requirements.txt # Python 依赖列表 ├─ dormitory.db # SQLite 数据库文件 ├─ schema.sql # 数据库结构参考文件 ├─ dormitory_manager/ # 项目源代码、页面和静态资源 └─ tests/ # 自动化测试重要所有命令都要在包含run.py的“学生宿舍管理系统”目录中执行。不要在它的上一层目录中执行。二、部署前准备2.1 推荐环境操作系统Windows 10/11或 Ubuntu 22.04/24.04Python推荐 Python 3.11 或 3.1264 位内存至少 1 GB建议 2 GB 以上磁盘至少预留 500 MB浏览器Chrome、Edge 或 Firefox2.2 Windows 安装 Python打开 Python 官方下载页https://www.python.org/downloads/windows/下载 64 位 Python 安装程序。双击安装程序。一定勾选Add Python to PATH。点击Install Now完成安装。按Win R输入powershell回车。输入以下命令检查python--version python-m pip--version能够显示版本号就说明安装成功。若提示“找不到 python”请关闭 PowerShell 后重新打开仍无效时重新安装 Python 并确认勾选了Add Python to PATH。三、方案一Windows 本机运行最简单推荐新手第 1 步解压项目将项目压缩包完整解压例如解压到D:\学生宿舍管理系统打开该目录确认能看到run.py requirements.txt dormitory_manager dormitory.db不要只复制run.py项目内的所有文件和子目录都必须保留。第 2 步打开项目目录中的 PowerShell方法一在资源管理器中打开项目目录点击地址栏输入powershell回车。方法二先打开 PowerShell再执行Set-Location-LiteralPathD:\学生宿舍管理系统请把示例路径替换成你自己的真实项目路径。用下面的命令确认当前目录正确Get-ChildItem输出中能看到run.py和requirements.txt才能继续。第 3 步创建虚拟环境python-m venv.venv命令执行完成后目录中会出现.venv文件夹。这一步通常只需执行一次。第 4 步激活虚拟环境.\.venv\Scripts\Activate.ps1激活成功后命令行开头通常会出现(.venv)。如果提示“禁止运行脚本”或running scripts is disabled先执行Set-ExecutionPolicy-ScopeProcess-ExecutionPolicy Bypass.\.venv\Scripts\Activate.ps1这里的设置只对当前 PowerShell 窗口有效不会永久修改系统策略。如果使用的是 CMD不要执行上面的激活命令请改用.venv\Scripts\activate.bat第 5 步安装依赖python-m pip install--upgrade pip python-m pip install-r requirements.txt看到Successfully installed表示安装成功。网络较慢时请耐心等待不要中途关闭窗口。可用以下命令检查 Flask 是否安装成功python-m flask--version第 6 步选择数据库初始化方式下面三种方式只能按实际需要选择一种。方式 A直接使用项目自带数据库拿到完整项目后最快如果目录中已有dormitory.db而且希望保留其中数据不要执行任何初始化命令直接进入第 7 步启动。方式 B重置为演示数据适合课程展示危险下面的seed-demo会删除数据库中的全部原有数据然后重新写入演示数据。正式数据环境禁止执行。先备份原数据库Copy-Item-LiteralPath.\dormitory.db-Destination.\dormitory-backup-$(Get-Date-FormatyyyyMMdd-HHmmss).db确认备份文件生成后再重置演示数据python-m flask--app dormitory_manager seed-demo方式 C创建全新的空数据库适合正式开始使用如果已有数据库先将其改名备份Rename-Item-LiteralPath.\dormitory.db-NewNamedormitory-old-$(Get-Date-FormatyyyyMMdd-HHmmss).db然后创建空数据库表python-m flask--app dormitory_manager init-db首次打开系统后进入注册页面注册的第一个用户会自动成为系统管理员。请为第一个账户设置不容易猜到的密码。第 7 步启动系统新手本机体验可执行python run.py也可以使用 Flask 命令启动python-m flask--app dormitory_manager run终端出现类似内容表示启动成功Running on http://127.0.0.1:5000注意这个 PowerShell 窗口必须保持打开。关闭窗口或按Ctrl C后系统就会停止。第 8 步浏览器访问打开浏览器在地址栏输入http://127.0.0.1:5000不要在搜索框中输入也不要把地址写成https://。如果使用演示数据库可使用以下账户角色用户名密码系统管理员adminadmin123宿舍管理员managermanager123学生studentstudent123演示账户密码是公开的。只要系统会被其他人访问就必须登录管理员账户在用户管理中修改密码或创建新的安全账户并停用演示账户。第 9 步停止和再次启动停止系统回到正在运行程序的 PowerShell按Ctrl C。以后再次启动时不需要重建虚拟环境也不需要重新安装依赖。只需执行Set-Location-LiteralPathD:\学生宿舍管理系统.\.venv\Scripts\Activate.ps1 python run.py