# RUN_COMMANDS · 10 个实训的运行指令与端口

> 项目根：`D:\JR 区块链\01_python_web_1061100024\03_practicum_labs`
> 解释器：`.venv\Scripts\python.exe`（Python 3.13.14，依赖已装齐）

## 一、三种启动方式（每个实训通用）

| 方式 | 命令 / 操作 | 说明 |
|---|---|---|
| **PyCharm** | 右上角运行配置下拉框选对应项 → 点绿三角（或 `Shift+F10`） | 上课演示用 |
| **双击** | 进实训文件夹，双击 `run.bat` | 自动切到项目 `.venv`，学生自己练 |
| **命令行** | 见下表 | 排错、批量验证用 |

命令行统一写法（在本实训文件夹里执行）：

```bat
..\.venv\Scripts\python.exe app.py
```

停止服务：终端里按 `Ctrl + C`，或点 PyCharm 运行面板的红色方块。

## 二、十个实训的端口与指令

| 实训 | 目录 | 端口 | 浏览器地址 | 命令行 |
|---|---|---|---|---|
| 01 | `lab01_flask_routing` | 5110 | http://127.0.0.1:5110/ | `..\.venv\Scripts\python.exe app.py` |
| 02 | `lab02_request_response` | 5111 | http://127.0.0.1:5111/ | 同上 |
| 03 | `lab03_web_frontend` | 5112 | http://127.0.0.1:5112/ | 同上 |
| 04 | `lab04_jinja2_templates` | 5113 | http://127.0.0.1:5113/ | 同上 |
| 05 | `lab05_forms_and_upload` | 5101 | http://127.0.0.1:5101/ | 同上 |
| 06 | `lab06_sqlalchemy_crud` | 5115 | http://127.0.0.1:5115/ | 同上 |
| 07 | `lab07_flask_migrate` | 5129 | http://127.0.0.1:5129/ | 同上 |
| 08 | `lab08_app_factory_blueprints` | 5116 | http://127.0.0.1:5116/ | 同上 |
| 09 | `lab09_flask_login` | 5117 | http://127.0.0.1:5117/ | 同上 |
| 10 | `lab10_blog_project` | 5118 | http://127.0.0.1:5118/ | 同上 |

> 端口互不冲突，**可以同时开多个**（一台电脑上开 10 个没问题）。

## 三、几个特殊指令

**lab07（Flask-Migrate）还要跑迁移三连**（在本目录）：

```bat
..\.venv\Scripts\python.exe -m flask --app app db upgrade     :: 应用迁移
..\.venv\Scripts\python.exe -m flask --app app db current     :: 看当前版本
..\.venv\Scripts\python.exe -m flask --app app db history     :: 看历史
```

**lab08（蓝图）有自定义 CLI**：

```bat
..\.venv\Scripts\python.exe -m flask --app app init-db        :: 建表
..\.venv\Scripts\python.exe -m flask --app app shell          :: 进交互环境
```

**看路由清单**（任意实训）：

```bat
..\.venv\Scripts\python.exe -m flask --app app routes
```

**恢复初始数据库**（把 06/09/10 造的脏数据清掉）：

```bat
..\.venv\Scripts\python.exe reset_all.py
```

## 四、建环境（只在换电脑时需要）

```bat
setup_env.bat          :: 建 .venv + 装依赖 + 自检
fix_interpreter.ps1        :: 把 .venv 登记成 PyCharm 解释器（关掉 PyCharm 后跑）
```

## 五、关于中文路径（实测结论）

当前路径含中文与空格：`D:\JR 区块链\...\03_practicum_labs\lab01_flask_routing`。

在本机（Windows 11 + Python 3.13.14 + Flask 3.1.3）实测：

| 测试项 | 结果 |
|---|---|
| `pip install -r requirements.txt` | ✅ `No broken requirements found` |
| `python -m flask --app app routes` | ✅ 正确列出 6 条路由 |
| `python app.py` + 浏览器访问 | ✅ HTTP 200 |
| SQLite 建库（lab06 `students.db`） | ✅ 文件正常生成、页面 200 |
| `python -m http.server` 预览课件 | ✅ HTTP 200 |
| `run.bat`（含 `chcp 65001`） | ✅ 双击即跑，中文提示不乱码 |

**结论：可以放心用中文目录名。** 真正容易出事的是**空格**（路径里有 "JR 区块链"、"一本书一文件夹" 的空格在部分工具里会被截断），本项目已在所有脚本里做了引号处理：

- `run.bat` 用 `cd /d "%~dp0"` 和 `"%PY%" app.py`，路径都带引号；
- `.idea` 运行配置用 `$PROJECT_DIR$` 宏，不写死绝对路径；
- Python 侧不拼裸路径字符串（Flask 的 `static/templates` 走包定位，SQLite 用相对路径）。

仍建议避开的情况（不是中文，而是这些）：

1. 路径里再出现 `%`、`&`、`!` 这类符号（bat 会吃掉）；
2. 把项目放到 OneDrive/坚果云同步目录（同步锁会导致 `Address already in use`、数据库被占用）；
3. 用 **Anaconda base** 当解释器跑（依赖版本冲突），本项目一律用自带 `.venv`。
