lab05_forms_and_upload · walkthrough

step by step第4章 与用户交互端口 5101 地址 http://127.0.0.1:5101/ 截图全部本机实拍

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

教材《第4章 与用户交互》对应的 PPT 共 7 个要点小节,下面前 7 个是本节主干,完整版见 knowledge/ch04.md。

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

  1. 了解消息反馈的基本操作
  2. 掌握Flask-WTF表单模块
  3. 掌握Flask-CKEditor模块
  4. Flask-CKEditor
  5. 网页的交互是指用户通过与网页上的元素(如按钮、表单、链接等)进行互动,以触发和响应网页的动态行为或功能。这种互动性是现代网页应用程序的关键组成部分,它使用户能够与网页进行实时通信、提交表单、加载新内容、执行操作等。
  6. 在网页中,如果需要与用户进行交互,则需要为交互页面设计一种特定的消息类型(表单),用于接收用户输入的信息。将用户输入的信息传递到服务器中进行处理,如需要返回消息给用户,则需要将消息内容显示到网页内容中。一次完整的交互,不止是有前端的页面显示
  7. 数据的交互会有GET请求和POST请求。这两种请求方法在 Web 开发中广泛使用,用于在客户端(浏览器)和服务器之间传递数据。
  8. 用途: GET 请求用于从服务器获取数据。它通常用于请求获取页面、图像、文档等静态资源,或者从服务器获取特定数据。
  9. 数据传递: 数据通过 URL 查询字符串传递,附加在 URL 后面,以问号(?)分隔。例如:http://example.com/page?param1=value1&param2=value2
  10. 安全性: GET 请求在 URL 中明文传递数据,因此不适合传递敏感信息,因为信息可以在浏览器历史记录、服务器日志等地方可见。
  11. 缓存: GET 请求可以被浏览器缓存,因此可以加快页面加载速度。
  12. 幂等性: 多次发送相同的 GET 请求不会对服务器产生副作用,即多次请求不会改变服务器状态。

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

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

三、打开本实训并运行

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

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

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

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

#路由实际地址状态这一屏在讲什么
1//200四小节导航
2/basic/basic200GET 与 POST 的区别
3/files/files200已上传文件列表
4/post/post200CKEditor 富文本发帖
5/upload/upload200安全上传:类型/大小/后缀

1/ — 四小节导航

对应视图函数 index(),代码处的注释:★ 本节重点:四小节导航

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

2/basic — GET 与 POST 的区别

对应视图函数 basic(),代码处的注释:★ 本节重点:GET 与 POST 的区别

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

3/files — 已上传文件列表

对应视图函数 files(),代码处的注释:★ 本节重点:已上传文件列表

① 浏览器里看到的效果:已上传文件列表
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 107 行 @app.route('/files') → def files()
在 PyCharm 里按 Ctrl+G 输入 107 回车,光标就跳到这一行
来源:本机实拍(PyCharm,Ctrl+G 定位)

4/post — CKEditor 富文本发帖

对应视图函数 post(),代码处的注释:★ 本节重点:CKEditor 富文本发帖

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

5/upload — 安全上传:类型/大小/后缀

对应视图函数 upload(),代码处的注释:★ 本节重点:安全上传表单(三重校验)

① 浏览器里看到的效果:安全上传:类型/大小/后缀
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 82 行 @app.route('/upload') → def upload()
在 PyCharm 里按 Ctrl+G 输入 82 回车,光标就跳到这一行
来源:本机实拍(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左侧展开 lab05_forms_and_upload → 双击 app.py 编辑器打开代码,第一段注释写着「本节重点」;右下角显示 Python 3.13
2点绿三角,或按 Ctrl+Shift+F10 下方运行面板出现 Running on http://127.0.0.1:5101
3浏览器地址栏输入 http://127.0.0.1:5101/ 看到本实训首页
4打开 lab05_forms_and_upload/app.py 运行,端口 5101运行面板 Running on 5101
5浏览器打开 /basic,姓名留空直接提交页面上出现红色校验提示(前端+后端都拦)
6打开 /upload,上传一个 .txt 文件被拒绝:类型不允许
7上传一张 png 图片成功,/files 里能看到文件
8回到运行面板看日志每提交一次就多一行 POST /basic 200
N要停下来时:运行面板左侧红色 ■ 面板显示「进程已结束」;不点它,下次运行会报 Address already in use
本章新学的 PyCharm 手法:新手法:边上页面操作,边看运行面板的请求日志
复用:打开项目、打开文件、运行、停止这几步,从第 1 章起每节课都一样,越用越熟。
不会打命令?把手册里的命令选中复制,在 PyCharm 底部终端(Alt+F12)里 Ctrl+V 粘贴,回车即可。 路径里有空格时要在外面包一层英文双引号。

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

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

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

现象:终端第一行就是 ModuleNotFoundError

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

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

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

② 400:The CSRF token is missing

现象:400:The CSRF token is missing

原因:表单里没有 csrf_token 就提交

怎么解决:模板补回 {{ form.csrf_token }};不要关闭 CSRF 保护

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

七、交付物与实训报告

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