# 首次使用 · 三步跑起来

> 目标：不折腾配置，先把第一个页面跑出来。全程 3 分钟。

## 第 1 步：确认解释器（点一次就好）

1. PyCharm → `File → Open` → 选 **本文件夹**（`03_practicum_labs`）。
2. 顶部若出现黄条「未为项目配置 Python 解释器」→ 点右侧 **Configure Python interpreter**。
3. `Add Interpreter → Add Local Interpreter → Existing` → 解释器选：
   ```
   <本文件夹>\.venv\Scripts\python.exe
   ```
4. `OK → Apply`。黄条消失、右下角显示 `Python 3.13 (.venv)` 即成功。

> 这个 `.venv` 已经在交付时建好并装齐依赖（Flask 3.1 / SQLAlchemy / WTForms / Login / CKEditor / Bootstrap / Migrate），**不需要再 pip install**。

## 第 2 步：跑第一个实训

两种方式任选：

- **PyCharm 里**：右上角运行配置下拉框选 `实训01 · 第1章 第一个Flask程序·路由四件套（5110）` → 点 ▶
- **不开 PyCharm**：进 `实训01_第1章_第一个Flask程序_路由四件套\` → 双击 `启动.bat`

终端出现下面这行才算成功：

```
* Running on http://127.0.0.1:5110
```

## 第 3 步：照着图文教程走

每个实训文件夹里有三份东西：

| 文件 | 用途 |
|---|---|
| `喂饭级图文教程.html` | **双击就开**：装 Python → 配解释器 → 跑起来 → 每页看到什么，一步一图 |
| `运行说明.md` | 三步启动、要访问的地址、验收清单、报错表 |
| `启动.bat` | 双击直接跑（自动用 `.venv`） |

## 常见问题

| 现象 | 解决 |
|---|---|
| 黄条「未为项目配置 Python 解释器」 | 做第 1 步 |
| `ModuleNotFoundError: flask` | 解释器选成了系统 Python，重做第 1 步；或双击 `setup_env.bat` |
| `Address already in use` | 上一个窗口没关，按 `Ctrl+C`；或改 `app.py` 最后一行的 `port=` |
| 双击 `启动.bat` 一闪就没了 | 在 PyCharm 的 Terminal 里手动敲 `.venv\Scripts\python.exe app.py` 看报错 |

## 端口对照（10 个实训互不冲突，可同时开）

| 实训 | 端口 | 实训 | 端口 |
|---|---|---|---|
| 01 路由四件套 | 5110 | 06 数据库存储 | 5115 |
| 02 请求与响应 | 5111 | 07 数据库迁移 | 5129 |
| 03 Web前端基础 | 5112 | 08 应用工厂与蓝图 | 5116 |
| 04 Jinja2模板 | 5113 | 09 用户认证 | 5117 |
| 05 表单与上传 | 5101 | 10 综合博客 | 5118 |


---

## 加急：黄条还在怎么办（一条命令解决）

如果打开后顶部仍显示「未为项目配置 Python 解释器」，先关掉 PyCharm，然后在本文件夹里右键
`fix_interpreter.ps1` → 使用 PowerShell 运行。它会做两件事：

1. 把项目自带的 `.venv` 登记成 PyCharm 的解释器（写进 PyCharm 用户配置 `jdk.table.xml`）；
2. 把项目 `.idea` 指向这个解释器。

再打开 PyCharm 就是配好的状态：黄条消失、右下角显示 `Python 3.13 (03_practicum_labs)`、右上角绿三角可点。

> 这一步我在这台电脑上已经做完并实测：用 `Shift+F10` 跑起 实训01，运行面板里出现
> `Running on http://127.0.0.1:5110`，浏览器访问返回 200。截图收录在
> `00_setup_screenshots\05~08` 四张图里（教程第 2、3、4 步用的就是它们）。
