Update for 4th edition

.gitignore

@@ -4,3 +4,4 @@ _ebook
 env
 venv
 site
+.obsidian

CHANGES.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 4.0
+
+Released: 2025/10/12
+
+- 增加对 uv 的介绍
+- 升级到 SQLAlchemy 2.x
+- 针对 Flask 3.1.x 进行内容更新
+- 增加对蓝本、工厂函数的介绍
 
 ## 3.0
 

README.md

@@ -1,11 +1,13 @@
 # Flask 入门教程
 
-这里是《Flask 入门教程》的源码仓库。请访问[本书主页](http://helloflask.com/book/3)在线阅读或下载电子书文件。
+> 使用 Python 和 Flask 开发你的第一个 Web 程序
+
+这里是《Flask 入门教程》的源码仓库。请访问[本书主页](http://helloflask.com/book/3)在线阅读本书。
 
 如果你发现了书中的错误，或是有任何意见或建议，欢迎[创建 Issue](https://github.com/helloflask/flask-tutorial/issues/new) 反馈或提交 Pull Request 进行修正。对于较大的内容变动，建议先[创建 Issue](https://github.com/helloflask/flask-tutorial/issues/new) 进行讨论。谢谢！
 
 ![](http://helloflask.com/static/tutorial-cover-s.png)
 
-© 2018 [李辉](http://greyli.com)（Grey Li） / [HelloFlask.com](http://helloflask.com)
+© 2018 - 2025 [李辉](http://greyli.com)（Grey Li） / [HelloFlask](http://helloflask.com)
 
 本书采用 [CC BY-NC-ND 3.0](https://creativecommons.org/licenses/by-nc-nd/3.0/deed.zh) 协议授权，禁止商用、演绎后分发或无署名转载。

chapters/1-preparation-code-listing.md

@@ -0,0 +1,104 @@
+# 第 1 章：代码清单
+
+每一章后面都会有一个代码清单章节，这里会列出上一章所有的代码变动和相关命令。本章的目的是提供一个更清晰的代码改动列表，供你在编写代码时作为参考。
+
+## 目录
+
+```text
+watchlist/
+├── .venv/
+├── .git/
+└── .gitignore
+```
+
+## 代码
+
+### .gitignore
+
+```text
+*.pyc
+*~
+__pycache__
+.DS_Store
+.venv
+```
+
+## 命令
+
+### 创建项目文件夹
+
+```bash
+$ mkdir watchlist
+$ cd watchlist
+```
+
+### 设置 Git 身份信息
+
+```bash
+$ git config --global user.name "Your Name"  # 替换成你的名字
+$ git config --global user.email "[email protected]"  # 替换成你的邮箱地址
+```
+
+### 初始化 Git 仓库
+
+```bash
+$ git init
+Initialized empty Git repository in ~/watchlist/.git/
+```
+
+### 创建 .gitignore 文件
+
+```bash
+$ nano .gitignore
+```
+
+### 生成 SSH 密钥
+
+```bash
+$ ssh-keygen -t ed25519 -C "[email protected]"
+$ cat ~/.ssh/id_ed25519.pub
+```
+
+### 设置远程仓库
+
+```bash
+$ git remote add origin [email protected]:greyli/watchlist.git  # 注意更换地址中的用户名
+```
+
+### 创建虚拟环境
+
+```bash
+$ python -m venv .venv  # Windows
+```
+
+或：
+
+```bash
+$ python3 -m venv .venv  # Linux 和 macOS
+```
+
+### 激活虚拟环境
+
+```bash
+$ .venv\Scripts\activate  # Windows
+```
+
+或：
+
+```bash
+$ source .venv/bin/activate  # Linux 或 macOS
+```
+
+### 安装 Flask
+
+```bash
+(.venv) $ pip install flask
+```
+
+### 提交代码
+
+```bash
+$ git add .
+$ git commit -m "Init the project"
+$ git push -u origin main
+```