# 第1章 · Flask 基础

对应教材第 1 章：应用的初始化、启动服务器、路由、请求与响应、Cookie 与 Session。

本章有两个项目，**从“只有路由”到“能记住你是谁”**，一次讲完一个 Web 程序最小可用的骨架。

| 项目 | 端口 | 一句话 |
|---|---|---|
| `ch1a` | 5110 | 应用怎么创建、URL 怎么映射到函数、动态参数怎么取 |
| `ch1b` | 5111 | 服务器怎么知道“这次请求是谁发的”，怎么在多次请求之间记住状态 |

---

## 运行

```bat
cd ch01\ch1a
..\..\..\venv\Scripts\python.exe app.py
```

浏览器打开 <http://127.0.0.1:5110>。`Ctrl + C` 停止。

换第二个项目就把目录换成 `ch1b`，地址换成 <http://127.0.0.1:5111>。

一次性启动也行：

```bat
python tools\run.py ch01/ch1a
```

---

## ch1a：路由是什么

文件：`ch1a/app.py`（44 行）

| 教材知识点 | 代码位置 | 说明 |
|---|---|---|
| 应用的初始化 | `app = Flask(__name__)` | `__name__` 让 Flask 知道去哪找 `templates/` 和 `static/` |
| 启动服务器 | `app.run(debug=True, port=5110)` | `debug=True` 改代码自动重启，出错显示堆栈 |
| 固定路由 | `@app.route('/')` | 一个 URL 对应一个函数，这就是“路由” |
| 动态路由 | `@app.route('/user/<name>')` | 尖括号是变量，同一套代码服务所有用户 |
| 类型转换器 | `@app.route('/post/<int:post_id>')` | 只匹配整数，`/post/abc` 直接 404 |
| 重定向 | `redirect(url_for('user', name='...'))` | `url_for` 用**函数名**反查 URL，改路由不会断链 |
| 主动 404 | `abort(404)` | 资源不存在时主动抛状态码 |

访问顺序建议：

```
/            → 首页，四个链接
/user/张三    → 动态路由取到“张三”
/post/7      → int 转换器，post_id 是 int 类型
/post/abc    → 404（因为转换器不匹配）
/go-baidu    → 302 重定向到 /user/...
/nothing     → 主动 404
```

**一句话结论**：Flask 的核心就三件事 —— 创建 `app`、用 `@app.route` 挂 URL、函数返回字符串（就是 HTML）。

---

## ch1b：服务器怎么记住你

文件：`ch1b/app.py`（约 70 行）

HTTP 是**无状态**的：每个请求都是新的，服务器天生不认识你。所以需要 Cookie 和 Session。

| 教材知识点 | 代码位置 | 说明 |
|---|---|---|
| `request` 对象 | `/info` 路由 | `method` / `path` / `args` / `headers` / `remote_addr` 一屏看全 |
| 读表单数据 | `request.form.get('username')` | POST 上来的字段都在这 |
| 写 Session | `session['user'] = name` | 数据存在**服务器**，浏览器只拿到一个签名的 session id |
| 删 Session | `session.pop('user', None)` | 退出登录 |
| Cookie 读写 | `request.cookies.get()` / `resp.set_cookie()` | 数据存在**浏览器**，每次请求自动带上 |
| 自定义响应 | `make_response(html, 404)` | 要改状态码或响应头，必须先包成响应对象 |

演示流程：

```
1. 打开 /            → 你好，游客！（第 1 次访问）
2. 刷新几次           → 第 2 次、第 3 次……（Cookie 在计数）
3. /login 输入昵称    → 重定向回首页，变成“你好，张三！”
4. 按 F12 → Application → Cookies  → 能看到 visit，但看不到 user
5. /logout           → 又变回游客
6. /status           → 浏览器返回 404，但页面内容是我们自己写的
```

**Cookie 和 Session 的区别，一句话**：

> Cookie 把数据放在**用户电脑**上（能被看到、能被改）；Session 把数据放在**服务器**上，浏览器只拿一个编号。所以密码、登录状态这类东西必须放 Session。

关键细节：`app.secret_key`：

```python
app.secret_key = 'shefucai-key'   # 没有它，一用 session 就报错
```

Flask 的 Session 是**签名过的 Cookie**（不是服务器内存），密钥用来防篡改。密钥泄露等于所有人的登录态都能伪造，所以生产环境必须放到环境变量里，不能写死在代码里。

---

## 常见坑

| 现象 | 原因 | 解决 |
|---|---|---|
| `RuntimeError: The session is unavailable because no secret key was set` | 没设 `secret_key` | 加一行 `app.secret_key = '...'` |
| 改了 Cookie 但刷新没变化 | `return html` 直接返回字符串，没法设 Cookie | 先 `make_response(html)` 再 `set_cookie()` |
| `/post/abc` 报 404 而不是报错 | 这是正常的 | `int:` 转换器只匹配整数，不匹配就直接 404 |
| 端口被占用 | 上次的服务没关 | `Ctrl + C`，或 `netstat -ano \| findstr :5110` 后 `taskkill /F /PID xxx` |

---

## 练习

1. 给 `ch1a` 加一条路由 `/hello/<name>/<int:age>`，返回“张三今年 20 岁”。
2. 把 `ch1a` 的 `/go-baidu` 改成重定向到自己的 `/post/1`，观察地址栏变化。
3. 给 `ch1b` 加一个 `/clear` 路由，用 `resp.delete_cookie('visit')` 把访问计数清零。
4. 在 `/info` 页面增加一行，显示 `request.headers.get('Host')`，想想它和 `remote_addr` 有什么区别。
