lab08_app_factory_blueprints · walkthrough

step by step第6章 可维护性端口 5116 地址 http://127.0.0.1:5116/ 截图全部本机实拍

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

教材《第6章 可维护性》对应的 PPT 共 7 个要点小节,下面前 7 个是本节主干,完整版见 knowledge/ch06.md。

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

  1. 掌握合理地安排项目结构的方法
  2. 掌握使用配置文件完成应用实例
  3. 掌握蓝图的基本使用方法
  4. 掌握Flask-Login的基本使用方法
  5. 第1章的引言提到,Flask微框架的“微”并不是指把整个Web应用放入一个Python文件,而是指Flask旨在保持代码简洁且易于扩展。但在第3、4、5章的实例中,为方便读者调试、理解代码,大部分代码都是以单文件的方式编写的。本章将会以实用
  6. Flask-Login
  7. 在前几章的程序中,应用初始化时都会有诸如以下的代码。
  8. app.config['SECRET_KEY'] = 'Chapter5'
  9. app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///' + os.path. join(basedir, 'data.sqlite')
  10. app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
  11. 这些代码都是用于定义应用实例的一些参数、属性的,可以通过建立配置类,将这些零碎的配置项整合在一起,并可以通过类继承的方式建立多套配置方案,来实现不同环境下所需的设定。
  12. 以下是配置文件(config.py)的代码实现。

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

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

三、打开本实训并运行

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

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

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

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

#路由实际地址状态这一屏在讲什么
1//200蓝图 main 首页
2/about/about200蓝图 main 关于页
3/auth/login/auth/login200蓝图 auth 登录页

1/ — 蓝图 main 首页

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

2/about — 蓝图 main 关于页

① 浏览器里看到的效果:蓝图 main 关于页
来源:本机实拍(Edge,1280×800)
② 对应代码:main.py 第 13 行 @app.route('/about') → def about()
在 PyCharm 里按 Ctrl+G 输入 13 回车,光标就跳到这一行
来源:本机实拍(PyCharm,Ctrl+G 定位)

3/auth/login — 蓝图 auth 登录页

① 浏览器里看到的效果:蓝图 auth 登录页
来源:本机实拍(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左侧展开 lab08_app_factory_blueprints → 双击 app.py 编辑器打开代码,第一段注释写着「本节重点」;右下角显示 Python 3.13
2点绿三角,或按 Ctrl+Shift+F10 下方运行面板出现 Running on http://127.0.0.1:5116
3浏览器地址栏输入 http://127.0.0.1:5116/ 看到本实训首页
4打开 lab08_app_factory_blueprints/app.py 运行,端口 5116运行面板 Running on 5116
5在终端执行 cd "03_practicum_labs\lab08_app_factory_blueprints"进入 lab08
6执行 ..\.venv\Scripts\python.exe -m flask --app app routes列出 /、/about、/auth/login 三条路由,说明蓝图注册成功
7打开 extensions.py 看 db = SQLAlchemy()理解单例:全项目只有一份 db
N要停下来时:运行面板左侧红色 ■ 面板显示「进程已结束」;不点它,下次运行会报 Address already in use
本章新学的 PyCharm 手法:新手法:用 flask routes 核对路由,404 时第一件事就是查它
复用:打开项目、打开文件、运行、停止这几步,从第 1 章起每节课都一样,越用越熟。
不会打命令?把手册里的命令选中复制,在 PyCharm 底部终端(Alt+F12)里 Ctrl+V 粘贴,回车即可。 路径里有空格时要在外面包一层英文双引号。

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

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

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

现象:终端第一行就是 ModuleNotFoundError

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

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

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

② 404:/about 打不开(蓝图没注册)

现象:404:/about 打不开(蓝图没注册)

原因:注释掉 register_blueprint(main_bp)

怎么解决:在 create_app 里把 main / auth 两个蓝图都注册上

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

七、交付物与实训报告

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