Fix outdated docs

Author: greyli

chapters/1-preparation.md

@@ -279,7 +279,7 @@ $ source .venv/bin/activate  # Windows 使用 .venv\Scripts\activate 命令
 然后使用 uv 安装依赖：
 
 ```shell
-$ uv pip install flask
+(.venv) $ uv pip install flask
 ```
 
 除了像这样使用 uv 来代理 pip 操作，你也可以完成使用 uv 自带的依赖管理系统，详情可以访问文档 <https://docs.astral.sh/uv/guides/projects/> 了解。

chapters/5-database.md

@@ -71,7 +71,8 @@ SQLITE_PREFIX = 'sqlite:///' if sys.platform.startswith('win') else 'sqlite:////
 
 app = Flask(__name__)
 app.config['SQLALCHEMY_DATABASE_URI'] = SQLITE_PREFIX + str(Path(app.root_path) / 'data.db')
-db = SQLAlchemy(app)
+
+db = SQLAlchemy(app, model_class=Base)
 ```
 
 如果你固定在某一个操作系统上进行开发，部署时也使用相同的操作系统，那么可以不用这么做，直接根据你的需要写出前缀即可。

chapters/8-auth.md

@@ -25,14 +25,17 @@ False
 我们在存储用户信息的 `User` 模型类添加 `username` 字段和 `password_hash` 字段，分别用来存储登录所需的用户名和密码散列值，同时添加两个方法来实现设置密码和验证密码的功能：
 
 ```python
+from sqlalchemy import String
+from sqlalchemy.orm import Mapped, mapped_column
 from werkzeug.security import generate_password_hash, check_password_hash
 
 
 class User(db.Model):
-    id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(20))
-    username = db.Column(db.String(20))  # 用户名
-    password_hash = db.Column(db.String(128))  # 密码散列值
+    __tablename__ = 'user' # 定义表名称
+    id: Mapped[int] = mapped_column(primary_key=True)  # 主键
+    name: Mapped[str] = mapped_column(String(20))  # 名字
+    username: Mapped[str] = mapped_column(String(20))  # 用户名
+    password_hash: Mapped[str] = mapped_column(String(128))  # 密码散列值
 
     def set_password(self, password):  # 用来设置密码的方法，接受密码作为参数
         self.password_hash = generate_password_hash(password)  # 将生成的密码保持到对应字段
@@ -149,9 +152,9 @@ def login():
             flash('Invalid input.')
             return redirect(url_for('login'))
 
-        user = db.session.execute(select(User)).scalar()
-        # 验证用户名和密码是否一致
-        if username == user.username and user.validate_password(password):
+        user = db.session.get(select(User).filter_by(username=username)).scalar()
+        # 验证密码是否一致
+        if user is not None and user.validate_password(password):
             login_user(user)  # 登入用户
             flash('Login success.')
             return redirect(url_for('index'))  # 重定向到主页
@@ -285,7 +288,7 @@ def settings():
         current_user.name = name  # 更新当前用户的名字
         # current_user 会返回当前登录用户的数据库记录对象
         # 等同于下面的用法
-        # user = db.session.execute(select(User)).scalar()
+        # user = db.session.get(User, current_user.id)
         # user.name = name
         db.session.commit()
         flash('Settings updated.')

chapters/9-organize.md

@@ -102,8 +102,8 @@ app.register_blueprint(auth_bp)
 from flask import Flask
 
 def create_app():
-    app = Flask(__name__)
-	return app
+    app = Flask(__name__)  # 创建程序实例
+	return app  # 返回程序实例
 ```
 
 > **提示** 按照惯例，工厂函数一般会被命名为 create_app 或 make_app。
@@ -259,16 +259,17 @@ $ touch blueprints/auth.py blueprints/main.py  # 创建蓝本模块
 
 我们把这个包称为程序包，包里目前包含的模块和作用如下表所示：
 
-| 模块                 | 作用             |
-| ------------------ | -------------- |
-| \_\_init\_\_.py    | 包构造文件，包含工厂函数定义 |
-| settings.py        | 程序配置           |
-| errors.py          | 错误处理函数         |
-| models.py          | 模型类            |
-| commands.py        | 命令函数           |
-| extensions.py      | 扩展相关代码         |
-| blueprints/main.py | main 蓝本和相关视图函数 |
-| blueprints/auth.py | auth 蓝本和相关视图函数 |
+| 模块                         | 作用             |
+| -------------------------- | -------------- |
+| \_\_init\_\_.py            | 包构造文件，包含工厂函数定义 |
+| settings.py                | 程序配置           |
+| errors.py                  | 错误处理函数         |
+| models.py                  | 模型类            |
+| commands.py                | 命令函数           |
+| extensions.py              | 扩展相关代码         |
+| blueprints/\_\_init\_\_.py | 蓝本子包的构造文件，内容为空 |
+| blueprints/main.py         | main 蓝本和相关视图函数 |
+| blueprints/auth.py         | auth 蓝本和相关视图函数 |
 
 > **提示** 除了包构造文件外，其他的模块文件名你可以自由修改，比如 settings.py 也可以叫 config.py。
 
@@ -334,6 +335,8 @@ def load_user(user_id):
 	from watchlist.models import User
 	user = db.session.get(User, int(user_id))
 	return user
+
+login_manager.login_view = 'login'
 ```
 
 因为 models.py 模块需要导入存放在 extensions.py 中的 db 对象，为了避免循环依赖，`load_user()` 函数中使用的 User 模型类在函数内进行导入。
@@ -377,7 +380,7 @@ def create_app(config_name='development'):
 	return app
 ```
 
-我们为两个蓝本在 blueprints 子目录下分别创建了对应的模块。以认证蓝本为例，我们把 auth 蓝本的定义和相关视图函数放到了 auth.py 模块下。
+我们为两个蓝本在 blueprints 子包下分别创建了对应的模块（记得为 blueprints 子包创建一个构造文件 `__init__.py`）。以认证蓝本为例，我们把 auth 蓝本的定义和相关视图函数放到了 auth.py 模块下。
 
 *watchlist/blueprints/auth.py：认证蓝本*
 
@@ -397,10 +400,10 @@ def logout():
     ...
 ```
 
-其他代码则按照分类分别放到各自的模块中，这里不再给出代码，具体可参考[源码仓库](https://github.com/helloflask/watchlist)。在移动代码之后，注意添加并更新导入语句，比如使用下面的导入语句来导入程序实例：
+其他代码则按照分类分别放到各自的模块中，这里不再给出代码，具体可参考[源码仓库](https://github.com/helloflask/watchlist)。在移动代码之后，注意添加并更新导入语句，比如使用下面的导入语句来导入工厂函数：
 
 ```python
-from watchlist import app
+from watchlist import create_app
 ```
 
 使用下面的导入语句来导入扩展对象模型类和扩展对象：
@@ -452,11 +455,20 @@ def bad_request(e):
 FLASK_APP=watchlist
 ```
 
+为了更直观，我们也可以在项目根目录创建一个程序入口脚本，将其命名为 app.py：
+
+```python
+from watchlist import create_app
+
+app = create_app(config_name='development')
+```
+
 最终的项目文件结构如下所示：
 
 ```
 watchlist
 ├── .flaskenv
+├── app.py  # 可选的入口脚本
 └── watchlist  # 程序包
     ├── __init__.py
     ├── commands.py
@@ -465,6 +477,7 @@ watchlist
     ├── settings.py
 	├── extensions.py
     ├── blueprints
+	│   ├── __main__.py
     │   ├── main.py
     │   └── auth.py
     ├── static