lab07_flask_migrate · walkthrough

step by step第5章 数据库存储端口 5129 地址 http://127.0.0.1:5129/ 截图全部本机实拍

一、这节要学什么(来自教材配套 PPT)

教材《第5章 数据库存储》对应的 PPT 共 7 个要点小节,下面前 7 个是本节主干,完整版见 knowledge/ch05.md。

本节要点(PPT 原文摘录,共 12 条)

  1. 掌握控制台与Flask交互的方法
  2. 掌握Flask-SQLAlchemy数据库
  3. 掌握Flask-Migrate对数据库
  4. Flask-SQLAlchemy
  5. Flask-Script
  6. Flask-Migrate
  7. SQL数据库是什么?
  8. 结构化查询语言(Structured Query Language,SQL)专门为了数据库查询而设计,用于存取数据,查询、更新和管理数据库。
  9. SQL数据库通常是一种关系数据库,这种数据库通常会将数据存储在一个个数据表(表格)中。数据表的每一个字段(表格列)都是固定的,每一个对象的数据都映射到数据表的每一条记录(表格行)中。
  10. 为什么要用SQL数据库?
  11. 提供用户注册、文章发布等功能的网站都需要存储数据,在需要存储数据的情况下便需要使用数据库。通常情况下,数据库将按照一定规则来存储数据,这些规则使得数据变得规范化,相较于文件、目录方式存储更便于管理,且大部分的主流数据库在Flask中都具备完
  12. 后面主要用ORM框架对数据库操作,不直接使用SQL语句。所以不对sql的基础语句做过多讲解。

二、配解释器(整个项目只做一次)

打开项目若见黄条 → 点右侧「解释器设置」→「添加解释器」→「添加本地解释器」→「选择现有」→ 填 .venv\Scripts\python.exe → 确定。

三、打开本实训并运行

在项目里打开 lab07_flask_migrate/app.py,点绿三角或按 Shift+F10;成功标志是运行面板出现:

* Running on http://127.0.0.1:5129
① 打开 lab07_flask_migrate/app.py(红框①=代码区,②=顶部运行配置)
来源:本机实拍(PyCharm 2025.2.6)
② 运行面板出现 Running on http://127.0.0.1:5129
来源:本机实拍(PyCharm 2025.2.6)

四、每个地址都走一遍(共 1 屏)

下表是本实训全部 GET 路由,逐条打开对照截图;动态路由已代入示例值。

#路由实际地址状态这一屏在讲什么
1//200迁移后的学生列表(含 email 列)

1/ — 迁移后的学生列表(含 email 列)

对应视图函数 index(),代码处的注释:★ 本节重点:学生列表(含迁移新增的 email 列)

① 浏览器里看到的效果:迁移后的学生列表(含 email 列)
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 108 行 @app.route('/') → def index()
在 PyCharm 里按 Ctrl+G 输入 108 回车,光标就跳到这一行
来源:本机实拍(PyCharm,Ctrl+G 定位)

五、卡住了怎么办

现象原因解决
黄条「未为项目配置 Python 解释器」没选解释器做第二节
ModuleNotFoundError: flask解释器选成系统 Python重配到项目 .venv
Address already in use上一个服务没停运行面板点红色 Stop,或改 app.py 最后一行 port=
404地址拼错照第四节表格里的地址逐字敲
中文乱码终端编码运行配置加 PYTHONIOENCODING=utf-8(工程已配)

五、实践课:PyCharm 喂饭级操作步骤

每一步都写清“点哪里 / 按什么键 / 会看到什么”。不会敲代码也能照着做,命令全部用复制粘贴,别手打。

步你做这个动作屏幕上应该看到
0PyCharm → File → Open → 选 03_practicum_labs 左边出现 lab01…lab10 十个目录;若看到黄条,先做第二节配解释器
1左侧展开 lab07_flask_migrate → 双击 app.py 编辑器打开代码,第一段注释写着「本节重点」;右下角显示 Python 3.13
2点绿三角,或按 Ctrl+Shift+F10 下方运行面板出现 Running on http://127.0.0.1:5129
3浏览器地址栏输入 http://127.0.0.1:5129/ 看到本实训首页
4打开 lab07_flask_migrate/app.py 运行,端口 5129列表页显示学生和 email 列
5按 Alt+F12,cd "03_practicum_labs\lab07_flask_migrate"提示符到 lab07
6执行 ..\.venv\Scripts\python.exe -m flask --app app db upgrade终端打印 alembic 的 INFO ... Running upgrade
7改一处模型(例如给 name 加长度)→ 保存编辑器提示改了代码
8执行 ... db migrate -m 'change name',再 ... db upgrademigrations/versions 下多一个脚本,库结构随之更新
N要停下来时:运行面板左侧红色 ■ 面板显示「进程已结束」;不点它,下次运行会报 Address already in use
本章新学的 PyCharm 手法:新手法:终端里连跑三条命令(migrate/upgrade/downgrade),这是迁移的标准动作
复用:打开项目、打开文件、运行、停止这几步,从第 1 章起每节课都一样,越用越熟。
不会打命令?把手册里的命令选中复制,在 PyCharm 底部终端(Alt+F12)里 Ctrl+V 粘贴,回车即可。 路径里有空格时要在外面包一层英文双引号。

六、常见报错实战(真机复现的反面教材)

下面这些报错,是在 PyCharm 里真的跑出来再截屏的:先制造错误 → 点运行 → 复制运行面板截图。看到红字别慌,对照「怎么解决」照着改。

① 解释器选错:ModuleNotFoundError: No module named 'flask'

现象:终端第一行就是 ModuleNotFoundError

原因:解释器是系统 Python,不是项目 .venv。

怎么解决:设置 → 解释器 → 选 .venv\Scripts\python.exe;或右键 fix_interpreter.ps1。

来源:本机实拍(没有 Flask 的干净环境真跑)

② 没跑 upgrade:no such table

现象:没跑 upgrade:no such table

原因:删掉 migrate.db 后直接运行,没执行迁移

怎么解决:先跑 -m flask --app app db upgrade,再启动

来源:本机实拍(PyCharm 运行面板,真跑出来)

七、交付物与实训报告

文件用途
app.py代码(英文标识符 + 一行中文短注释)
README.md运行方式 / 路由表 / 验收点 / 指令
notes.md知识点与代码对应
run.bat双击启动
walkthrough.html本文件(图文手册)
实训报告_lab07_flask_migrate.docx可直接打印上交的图文报告(含截图)
报告里已排好:实训目的 / 知识点 / 环境 / 步骤(配图)/ 运行结果 / 问题与解决 / 小结。