lab09_flask_login · walkthrough

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

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

三、打开本实训并运行

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

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

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

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

#路由实际地址状态这一屏在讲什么
1//200首页(未登录状态)
2/login/login200登录页:密码只存哈希
3/logout/logout302注销(清登录态)
4/member/member302受保护页:未登录跳登录页

1/ — 首页(未登录状态)

对应视图函数 index(),代码处的注释:★ 本节重点:首页(显示当前登录状态)

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

2/login — 登录页:密码只存哈希

对应视图函数 login(),代码处的注释:★ 本节重点:登录(校验哈希)

① 浏览器里看到的效果:登录页:密码只存哈希
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 78 行 @app.route('/login') → def login()
在 PyCharm 里按 Ctrl+G 输入 78 回车,光标就跳到这一行
来源:本机实拍(PyCharm,Ctrl+G 定位)

3/logout — 注销(清登录态)

对应视图函数 logout(),代码处的注释:★ 本节重点:注销

① 浏览器里看到的效果:注销(清登录态)
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 91 行 @app.route('/logout') → def logout()
在 PyCharm 里按 Ctrl+G 输入 91 回车,光标就跳到这一行
来源:本机实拍(PyCharm,Ctrl+G 定位)

4/member — 受保护页:未登录跳登录页

对应视图函数 member(),代码处的注释:★ 本节重点:受保护页:未登录会被弹回登录页

① 浏览器里看到的效果:受保护页:未登录跳登录页
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 99 行 @app.route('/member') → def member()
在 PyCharm 里按 Ctrl+G 输入 99 回车,光标就跳到这一行
来源:本机实拍(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左侧展开 lab09_flask_login → 双击 app.py 编辑器打开代码,第一段注释写着「本节重点」;右下角显示 Python 3.13
2点绿三角,或按 Ctrl+Shift+F10 下方运行面板出现 Running on http://127.0.0.1:5117
3浏览器地址栏输入 http://127.0.0.1:5117/ 看到本实训首页
4打开 lab09_flask_login/app.py 运行,端口 5117运行面板 Running on 5117
5浏览器直接访问 /member被弹回登录页(302),地址变成 /login?next=/member
6用 xie / 123456 登录后再访问 /member这次能看到内容
7点注销再去 /member又被弹回:说明登录态清掉了
N要停下来时:运行面板左侧红色 ■ 面板显示「进程已结束」;不点它,下次运行会报 Address already in use
本章新学的 PyCharm 手法:新手法:看浏览器地址栏的 ?next=…,理解“登录后自动回原页”
复用:打开项目、打开文件、运行、停止这几步,从第 1 章起每节课都一样,越用越熟。
不会打命令?把手册里的命令选中复制,在 PyCharm 底部终端(Alt+F12)里 Ctrl+V 粘贴,回车即可。 路径里有空格时要在外面包一层英文双引号。

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

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

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

现象:终端第一行就是 ModuleNotFoundError

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

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

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

② Missing user_loader:登录直接崩

现象:Missing user_loader:登录直接崩

原因:注释掉 @login_manager.user_loader 后再登录

怎么解决:补回 load_user(user_id) 并加上 @login_manager.user_loader

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

七、交付物与实训报告

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