lab06_sqlalchemy_crud · walkthrough

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

一、这节要学什么(来自教材配套 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 → 确定。

三、打开本实训并运行

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

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

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

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

#路由实际地址状态这一屏在讲什么
1//200学生列表(分页,数据来自数据库)
2POST /add/200提交 POST /add 之后:学生总数 12 → 13

1/ — 学生列表(分页,数据来自数据库)

对应视图函数 index(),代码处的注释:★ 本节重点:学生列表(分页查询)

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

2POST /add — 提交 POST /add 之后:学生总数 12 → 13

① 浏览器里看到的效果:提交 POST /add 之后:学生总数 12 → 13
来源:本机实拍(Edge,1280×800)

五、卡住了怎么办

现象原因解决
黄条「未为项目配置 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左侧展开 lab06_sqlalchemy_crud → 双击 app.py 编辑器打开代码,第一段注释写着「本节重点」;右下角显示 Python 3.13
2点绿三角,或按 Ctrl+Shift+F10 下方运行面板出现 Running on http://127.0.0.1:5115
3浏览器地址栏输入 http://127.0.0.1:5115/ 看到本实训首页
4打开 lab06_sqlalchemy_crud/app.py 运行,端口 5115列表页显示 12 个学生
5浏览器访问 /add 填一个学生提交回到列表,变成 13 个,新来的在最后
6按 Alt+F12 打开底部终端,执行 cd "03_practicum_labs\lab06_sqlalchemy_crud"提示符变成 lab06 目录
7执行 ..\.venv\Scripts\python.exe -m flask --app app shell出现 >>>,进入 Python 交互
8输入 db.session.query(Student).count()打印 13——证明数据真进库了;输入 exit() 退出
N要停下来时:运行面板左侧红色 ■ 面板显示「进程已结束」;不点它,下次运行会报 Address already in use
本章新学的 PyCharm 手法:新手法:用 flask shell 直接查数据库,比刷新页面更能确认数据
复用:打开项目、打开文件、运行、停止这几步,从第 1 章起每节课都一样,越用越熟。
不会打命令?把手册里的命令选中复制,在 PyCharm 底部终端(Alt+F12)里 Ctrl+V 粘贴,回车即可。 路径里有空格时要在外面包一层英文双引号。

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

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

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

现象:终端第一行就是 ModuleNotFoundError

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

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

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

② OperationalError:no such table: students

现象:OperationalError:no such table: students

原因:数据库文件被删、又不建表就查询

怎么解决:删旧 db 重启会自动建表;或在 flask shell 里 db.create_all()

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

七、交付物与实训报告

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