lab02_request_response · walkthrough

step by step第1章 Flask 基础端口 5111 地址 http://127.0.0.1:5111/ 截图全部本机实拍

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

教材《第1章 Flask 基础》对应的 PPT 共 7 个要点小节,下面前 7 个是本节主干,完整版见 knowledge/ch01.md。

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

  1. 了解Web开发的基础概念
  2. 完成Flask开发环境的搭建
  3. 了解浏览网页的基本原理
  4. 重点掌握Flask框架,知道它是什么,我们为什么要用它,我们怎么去使用它。
  5. 难点是理解Web开发基础,框架的概念,应用的架构,模板引擎,表单处理等等内容。
  6. Flask的安装和配置
  7. Scenario import
  8. 如今,我们可以看到各种各样的Web应用,但大家不知道如何搭建,本次课程学习简洁高效的Flask框架,构建Web应用
  9. Flask框架是什么?
  10. Flask 是一个基于 Python 的轻量级 Web 应用框架,它旨在帮助开发者快速构建简单而强大的 Web 应用程序。与传统的重量级框架相比,Flask 提供了更大的灵活性,使开发者能够根据项目的需求进行定制。
  11. python社区支持
  12. 为什么要有Flask框架?
教材 PPT 原页(知识点示意)
来源:第1章 Flask 基础 配套 PPT

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

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

三、打开本实训并运行

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

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

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

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

#路由实际地址状态这一屏在讲什么
1//200首页:读 Cookie 计数、写回新值
2/info/info200打印 request 的 method/path/args/headers/IP
3/login/login200写 Session(登录)
4/logout/logout302删 Session(注销)
5/status/status200make_response 自定义状态码
6/status/404404/status/

1/ — 首页:读 Cookie 计数、写回新值

对应视图函数 index(),代码处的注释:★ 本节重点:首页:读 Cookie 里的访问次数 +1 再写回,并显示 Session 里的用户名

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

2/info — 打印 request 的 method/path/args/headers/IP

对应视图函数 info(),代码处的注释:★ 本节重点:把 request 的六个常用属性一次性打印出来

① 浏览器里看到的效果:打印 request 的 method/path/args/headers/IP
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 63 行 @app.route('/info') → def info()
在 PyCharm 里按 Ctrl+G 输入 63 回车,光标就跳到这一行
来源:本机实拍(PyCharm,Ctrl+G 定位)

3/login — 写 Session(登录)

对应视图函数 login(),代码处的注释:★ 本节重点:GET 显示表单,POST 把用户名写进 Session

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

4/logout — 删 Session(注销)

对应视图函数 logout(),代码处的注释:★ 本节重点:注销:删掉 Session 里的 user 再跳回首页

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

5/status — make_response 自定义状态码

对应视图函数 status(),代码处的注释:★ 本节重点:演示 make_response 自定义状态码(含 404/500 链接)

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

6/status/ — /status/

对应视图函数 status_code()

① 浏览器里看到的效果:/status/
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 94 行 @app.route('/status/') → def status_code()
在 PyCharm 里按 Ctrl+G 输入 94 回车,光标就跳到这一行
来源:本机实拍(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左侧展开 lab02_request_response → 双击 app.py 编辑器打开代码,第一段注释写着「本节重点」;右下角显示 Python 3.13
2点绿三角,或按 Ctrl+Shift+F10 下方运行面板出现 Running on http://127.0.0.1:5111
3浏览器地址栏输入 http://127.0.0.1:5111/ 看到本实训首页
4打开 lab02_request_response/app.py,运行运行面板显示 Running on http://127.0.0.1:5111
5浏览器访问 /,反复刷新 3 次页面上的访问次数从 1 变 2 变 3(Cookie 生效)
6访问 /login 随便填名字提交回到首页显示“已登录:xxx”(Session 生效)
N要停下来时:运行面板左侧红色 ■ 面板显示「进程已结束」;不点它,下次运行会报 Address already in use
本章新学的 PyCharm 手法:新手法:按 Alt+F12 打开底部终端,随便敲 dir 看目录
复用:打开项目、打开文件、运行、停止这几步,从第 1 章起每节课都一样,越用越熟。
不会打命令?把手册里的命令选中复制,在 PyCharm 底部终端(Alt+F12)里 Ctrl+V 粘贴,回车即可。 路径里有空格时要在外面包一层英文双引号。

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

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

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

现象:终端第一行就是 ModuleNotFoundError

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

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

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

② 服务端主动返回 404(/status/404)

现象:服务端主动返回 404(/status/404)

原因:make_response 的第二个参数就是状态码

怎么解决:想看正常页就访问 /status;想看错误码就访问 /status/404

来源:本机实拍(终端输出)

七、交付物与实训报告

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