5129 地址 http://127.0.0.1:5129/ 截图全部本机实拍教材《第5章 数据库存储》对应的 PPT 共 7 个要点小节,下面前 7 个是本节主干,完整版见 knowledge/ch05.md。
本节要点(PPT 原文摘录,共 12 条)
打开项目若见黄条 → 点右侧「解释器设置」→「添加解释器」→「添加本地解释器」→「选择现有」→ 填 .venv\Scripts\python.exe → 确定。
在项目里打开 lab07_flask_migrate/app.py,点绿三角或按 Shift+F10;成功标志是运行面板出现:
* Running on http://127.0.0.1:5129
lab07_flask_migrate/app.py(红框①=代码区,②=顶部运行配置)Running on http://127.0.0.1:5129下表是本实训全部 GET 路由,逐条打开对照截图;动态路由已代入示例值。
| # | 路由 | 实际地址 | 状态 | 这一屏在讲什么 |
|---|---|---|---|---|
| 1 | / | / | 200 | 迁移后的学生列表(含 email 列) |
/ — 迁移后的学生列表(含 email 列)对应视图函数 index(),代码处的注释:★ 本节重点:学生列表(含迁移新增的 email 列)
app.py 第 108 行 @app.route('/') → def index()Ctrl+G 输入 108 回车,光标就跳到这一行| 现象 | 原因 | 解决 |
|---|---|---|
| 黄条「未为项目配置 Python 解释器」 | 没选解释器 | 做第二节 |
ModuleNotFoundError: flask | 解释器选成系统 Python | 重配到项目 .venv |
Address already in use | 上一个服务没停 | 运行面板点红色 Stop,或改 app.py 最后一行 port= |
| 404 | 地址拼错 | 照第四节表格里的地址逐字敲 |
| 中文乱码 | 终端编码 | 运行配置加 PYTHONIOENCODING=utf-8(工程已配) |
每一步都写清“点哪里 / 按什么键 / 会看到什么”。不会敲代码也能照着做,命令全部用复制粘贴,别手打。
| 步 | 你做这个动作 | 屏幕上应该看到 |
|---|---|---|
| 0 | PyCharm → 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 upgrade | migrations/versions 下多一个脚本,库结构随之更新 |
| N | 要停下来时:运行面板左侧红色 ■ | 面板显示「进程已结束」;不点它,下次运行会报 Address already in use |
Alt+F12)里 Ctrl+V 粘贴,回车即可。
路径里有空格时要在外面包一层英文双引号。
下面这些报错,是在 PyCharm 里真的跑出来再截屏的:先制造错误 → 点运行 → 复制运行面板截图。看到红字别慌,对照「怎么解决」照着改。
原因:解释器是系统 Python,不是项目 .venv。
怎么解决:设置 → 解释器 → 选 .venv\Scripts\python.exe;或右键 fix_interpreter.ps1。
原因:删掉 migrate.db 后直接运行,没执行迁移
怎么解决:先跑 -m flask --app app db upgrade,再启动
| 文件 | 用途 |
|---|---|
app.py | 代码(英文标识符 + 一行中文短注释) |
README.md | 运行方式 / 路由表 / 验收点 / 指令 |
notes.md | 知识点与代码对应 |
run.bat | 双击启动 |
walkthrough.html | 本文件(图文手册) |
实训报告_lab07_flask_migrate.docx | 可直接打印上交的图文报告(含截图) |