lab01_flask_routing · walkthrough

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

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

三、打开本实训并运行

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

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

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

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

#路由实际地址状态这一屏在讲什么
1//200首页:四个路由入口
2/nothing/nothing404主动 abort(404)
3/post//post/5200int 转换器:只吃整数
4/redirect/redirect302重定向:跳到 /user/xiefucai
5/user//user/xiefucai200动态路由:URL 里的名字作为参数

1/ — 首页:四个路由入口

对应视图函数 index(),代码处的注释:★ 本节重点:首页:把四条演示路由列出来,便于逐个点开

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

2/nothing — 主动 abort(404)

对应视图函数 nothing(),代码处的注释:★ 本节重点:主动 abort(404):演示“地址存在但内容是错误码”

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

3/post/ — int 转换器:只吃整数

对应视图函数 post(),代码处的注释:★ 本节重点:int 转换器:只接受整数,顺便打印参数类型

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

4/redirect — 重定向:跳到 /user/xiefucai

对应视图函数 go_home(),代码处的注释:★ 本节重点:重定向:跳到 /user/xiefucai,演示 url_for 反查

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

5/user/ — 动态路由:URL 里的名字作为参数

对应视图函数 user(),代码处的注释:★ 本节重点:动态路由:URL 里的名字直接作为函数参数

① 浏览器里看到的效果:动态路由:URL 里的名字作为参数
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 39 行 @app.route('/user/') → def user()
在 PyCharm 里按 Ctrl+G 输入 39 回车,光标就跳到这一行
来源:本机实拍(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左侧展开 lab01_flask_routing → 双击 app.py 编辑器打开代码,第一段注释写着「本节重点」;右下角显示 Python 3.13
2点绿三角,或按 Ctrl+Shift+F10 下方运行面板出现 Running on http://127.0.0.1:5110
3浏览器地址栏输入 http://127.0.0.1:5110/ 看到本实训首页
4在左侧展开 lab01_flask_routing,双击 app.py编辑器里出现 5 个 @app.route,顶部标签变成 app.py
5点右上角绿三角(或按 Ctrl+Shift+F10)下方弹出运行面板,出现 Running on http://127.0.0.1:5110
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 的干净环境真跑)

② 访问 /post/abc:int 转换器不匹配

现象:访问 /post/abc:int 转换器不匹配

原因:int 转换器只吃数字,abc 匹配不到任何路由

怎么解决:把地址改成 /post/1,或把转换器换成

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

③ 端口被占用:Address already in use

现象:端口被占用:Address already in use

原因:上一次的服务没关,5110 还被占着

怎么解决:运行面板点红色 Stop;或改 app.py 最后一行的 port=

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

七、交付物与实训报告

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