lab10_blog_project · walkthrough

step by step第7章 综合实例端口 5118 地址 http://127.0.0.1:5118/ 截图全部本机实拍

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

教材《第7章 综合实例》对应的 PPT 共 7 个要点小节,下面前 7 个是本节主干,完整版见 knowledge/ch07.md。

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

  1. 理解如何根据项目需求设计
  2. 根据数据模型设计图完成
  3. 完成简易博客系统的开发
  4. 博客系统是一个典型的开发入门案例,其中包含了用户验证、内容管理、数据关联等基本功能实现的综合应用。本章将会从项目设计开始,逐步完成各个模块的开发,最终实现一个完整的简易博客系统。
  5. 在项目开发之前,需要了解项目需求;然后分析需求中所包含的功能,将各个功能划分到不同的模块,确立程序整体结构;接着分析各个模块所包含的功能,为需使用的数据模型设计具体结构。当项目设计完成之后,再将设计翻译成相应的代码实现。
  6. 一个简单的博客系统通常包含文章发布、文章分类、文章搜索、文章阅读量统计、文章留言、博客信息展示、友情链接展示等功能模块。
  7. 根据需求,可以分析出该系统的整体结构、功能模块架构,如下图所示。
  8. 该系统可以分成4个模块进行开发,各个模块负责各部分的内容。要注意的是,管理模块建立于其他模块之上(例如,先有用户模块,后有用户管理模块),接下来只要理解各个模块之间的关系,设计好相应的数据模型,最后为这些模块开发相应功能即可。
  9. 1.3 数据模型设计
  10. 了解程序模块结构后,便要对模块所包含的功能中所使用的“对象”进行设计,建立数据模型,完成数据库的创建。为右图图所示为各个数据模型类的简要设计图,包含模型属性及各个模型之间的关系。
  11. 根据设计图所描述的结构完成各个数据模型类的定义后(可参考书本5.3.2、5.3.5小节),便可以使用Flask-Migrate生成数据库。数据库建立完成之后,便可以开始开发相应的模块、功能。
  12. 在接下来的功能代码实现中,模板页面文件将放置于“templates”(模板)目录中,而Python代码文件放置于“模块”目录中;这是约定俗成的规则。详细的项目结构可参考书本6.2节,模块初始化代码可参考书本6.3节。

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

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

三、打开本实训并运行

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

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

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

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

#路由实际地址状态这一屏在讲什么
1//200博客首页文章列表
2/login/login200登录页(xie / 123456)
3/logout/logout302注销
4/new/new302写文章(需登录)
5/post//post/1200文章详情页

1/ — 博客首页文章列表

对应视图函数 index(),代码处的注释:★ 本节重点:博客首页:文章列表

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

2/login — 登录页(xie / 123456)

对应视图函数 login(),代码处的注释:★ 本节重点:登录(xie / 123456)

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

3/logout — 注销

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

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

4/new — 写文章(需登录)

对应视图函数 new(),代码处的注释:★ 本节重点:写文章(需登录)

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

5/post/ — 文章详情页

对应视图函数 detail(),代码处的注释:★ 本节重点:文章详情

① 浏览器里看到的效果:文章详情页
来源:本机实拍(Edge,1280×800)
② 对应代码:app.py 第 87 行 @app.route('/post/') → def detail()
在 PyCharm 里按 Ctrl+G 输入 87 回车,光标就跳到这一行
来源:本机实拍(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左侧展开 lab10_blog_project → 双击 app.py 编辑器打开代码,第一段注释写着「本节重点」;右下角显示 Python 3.13
2点绿三角,或按 Ctrl+Shift+F10 下方运行面板出现 Running on http://127.0.0.1:5118
3浏览器地址栏输入 http://127.0.0.1:5118/ 看到本实训首页
4打开 lab10_blog_project/app.py 运行,端口 5118运行面板 Running on 5118
5登录 xie / 123456 → 点“写文章”出现标题+正文表单
6发一篇,回到首页新文章出现在列表第一条
7点进详情,再点删除回到列表,文章没了
8把前面几章的招式复用一遍:改模板看变化、终端 flask routes、shell 查条数全部照旧能用——前六章的手法在这一章都还在用
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 的干净环境真跑)

② 302:没登录就访问 /new

现象:302:没登录就访问 /new

原因:未登录直接访问发文章页

怎么解决:@login_required 会重定向到登录页(这是保护)

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

七、交付物与实训报告

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