lab04_jinja2_templates · walkthrough

step by step第3章 模板端口 5113 地址 http://127.0.0.1:5113/ 截图全部本机实拍

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

教材《第3章 模板》对应的 PPT 共 7 个要点小节,下面前 7 个是本节主干,完整版见 knowledge/ch03.md。

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

  1. 了解静态网页与动态网页的区别
  2. 掌握Jinja2模板引擎的使用方法
  3. 掌握Flask-Bootstrap的使用方法
  4. Flask-Bootstrap
  5. Jinja2模板引擎
  6. 模板是一种通用的布局或结构,用于创建多个具有相似风格和功能的内容。在计算机编程和设计领域,模板是一个预定义的框架,其中包含了一些固定的元素、样式、格式或占位符,以便在特定场景中填充内容。使用模板可以帮助保持一致性、提高效率,并降低开发的重复
  7. jinja2模板引擎是什么?
  8. Jinja2 是一个流行的 Python 模板引擎,用于在 Python 应用程序中生成动态内容。模板引擎是一种将数据和模板结合,生成最终输出的工具。Jinja2 允许开发者将动态数据嵌入到静态模板中,以生成 HTML、XML、JSON 等
  9. 我们在第一章的时候,已经把Jinja2模板一同下载了下来,如果有不清楚的话,可以打开cmd(命令提示符),输入代码:pip install jinja2==2.11.3
  10. 在使用模板时,所有静态资源应放置在“static”资源目录下,而模板页面应放置在“templates”模板目录下。
  11. 我们要遵循一个思路,每当写一个模板页面,都要写他对应的视图函数,不然写了的页面就没法被浏览到。
  12. 我们来举一个简单的例子,首先在“templates”模板目录下创建一个模板页面文件,如下图所示。

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

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

三、打开本实训并运行

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

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

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

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

#路由实际地址状态这一屏在讲什么
1//200模板知识点导航
2/bootstrap/bootstrap200模板 + Bootstrap
3/control/control200if 判断与 for 循环
4/control//control/5200按参数控制循环次数
5/filter/filter200过滤器管道写法
6/global/global200全局对象(g / url_for / request)
7/include/include200include 引入片段
8/inherit/inherit200extends 模板继承
9/macro/macro200宏:可复用片段
10/macro//macro/5200宏带参数
11/macros/macros200宏集中定义文件
12/value/value200注入变量(默认值)
13/value//value/xiefucai200按参数注入变量

1/ — 模板知识点导航

对应视图函数 index(),代码处的注释:★ 本节重点:八个知识点的导航页

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

2/bootstrap — 模板 + Bootstrap

对应视图函数 bootstrap_demo(),代码处的注释:★ 本节重点:模板结合 Bootstrap

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

3/control — if 判断与 for 循环

对应视图函数 control(),代码处的注释:★ 本节重点:if 判断与 for 循环

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

4/control/ — 按参数控制循环次数

对应视图函数 control(),代码处的注释:★ 本节重点:按参数控制循环次数

① 浏览器里看到的效果:按参数控制循环次数
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 78 行 @app.route('/control/') → def control()
在 PyCharm 里按 Ctrl+G 输入 78 回车,光标就跳到这一行
来源:本机实拍(PyCharm,Ctrl+G 定位)

5/filter — 过滤器管道写法

对应视图函数 filter_demo(),代码处的注释:★ 本节重点:过滤器管道写法

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

6/global — 全局对象(g / url_for / request)

对应视图函数 global_(),代码处的注释:★ 本节重点:全局对象 g / url_for / request

① 浏览器里看到的效果:全局对象(g / url_for / request)
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 131 行 @app.route('/global') → def global_()
在 PyCharm 里按 Ctrl+G 输入 131 回车,光标就跳到这一行
来源:本机实拍(PyCharm,Ctrl+G 定位)

7/include — include 引入片段

对应视图函数 include_demo(),代码处的注释:★ 本节重点:include 引入页头页脚片段

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

8/inherit — extends 模板继承

对应视图函数 inherit(),代码处的注释:★ 本节重点:extends 模板继承

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

9/macro — 宏:可复用片段

对应视图函数 macro(),代码处的注释:★ 本节重点:宏:像函数一样渲染片段

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

10/macro/ — 宏带参数

对应视图函数 macro(),代码处的注释:★ 本节重点:宏带参数

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

11/macros — 宏集中定义文件

对应视图函数 macros(),代码处的注释:★ 本节重点:宏集中定义文件

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

12/value — 注入变量(默认值)

对应视图函数 value(),代码处的注释:★ 本节重点:变量注入(含默认值)

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

13/value/ — 按参数注入变量

对应视图函数 value(),代码处的注释:★ 本节重点:按 URL 参数注入变量

① 浏览器里看到的效果:按参数注入变量
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 58 行 @app.route('/value/') → def value()
在 PyCharm 里按 Ctrl+G 输入 58 回车,光标就跳到这一行
来源:本机实拍(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左侧展开 lab04_jinja2_templates → 双击 app.py 编辑器打开代码,第一段注释写着「本节重点」;右下角显示 Python 3.13
2点绿三角,或按 Ctrl+Shift+F10 下方运行面板出现 Running on http://127.0.0.1:5113
3浏览器地址栏输入 http://127.0.0.1:5113/ 看到本实训首页
4打开 lab04_jinja2_templates/app.py 运行,端口 5113运行面板 Running on 5113
5浏览器逐个点开 8 个演示页(/value、/control、/inherit…)每一页演示一种模板语法
6打开 templates/base.html,把页脚文字改掉保存所有子页面同时变化(继承生效)
7在模板里写一个不存在的变量 {{ ghost.name }} 保存刷新看到 UndefinedError 红字——这就是报错的样子,改回来即可
N要停下来时:运行面板左侧红色 ■ 面板显示「进程已结束」;不点它,下次运行会报 Address already in use
本章新学的 PyCharm 手法:新手法:故意制造一个小错误,看 PyCharm 运行面板红字,再改回来
复用:打开项目、打开文件、运行、停止这几步,从第 1 章起每节课都一样,越用越熟。
不会打命令?把手册里的命令选中复制,在 PyCharm 底部终端(Alt+F12)里 Ctrl+V 粘贴,回车即可。 路径里有空格时要在外面包一层英文双引号。

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

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

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

现象:终端第一行就是 ModuleNotFoundError

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

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

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

② UndefinedError:模板里访问不存在的变量

现象:UndefinedError:模板里访问不存在的变量

原因:模板写了 {{ ghost.name }},视图没传 ghost

怎么解决:视图补传变量,或模板用 {{ ghost|default('') }} 兜底

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

七、交付物与实训报告

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