PyCharm 2025.2.6 · 本机实拍

PyCharm 操作图解(这门课要用的全部操作)

截图都是在本机 PyCharm 里真点出来、真跑出来的。代码量很小:每章真正要敲的不到 30 行,其余时间都在做这页上的操作。
一句话流程:打开项目根 → 点开 labNN/app.py → 绿三角运行 → 浏览器看效果 → 出错就开底部终端敲 -m flask --app app routes 核对路由。

一、底部终端 Terminal(最常用)

1. 打开/收起终端

按 Alt+F12;或菜单 View → Tool Windows → Terminal;或点左下角 >_ 图标。

① 底部标签叫「终端」,② 里面就是 PowerShell,能敲任何命令

2. 看这个环境装了哪些包

.venv\Scripts\python.exe -m pip list

在项目根执行;如果在某个 lab 里,就用 ..\.venv\Scripts\python.exe -m pip list。

输出里有 Flask、Flask-SQLAlchemy、Flask-WTF、Flask-Login、Bootstrap-Flask 就说明环境齐了

3. 用一条命令列出本 lab 的所有路由

cd lab04_jinja2_templates
..\.venv\Scripts\python.exe -m flask --app app routes

这是排查 404 最快的办法:先看路由在不在,再怀疑地址拼错。

Endpoint / Methods / Rule 三列,就是这份代码对外提供的全部地址

4. 在终端里直接运行(和点绿三角等价)

..\.venv\Scripts\python.exe app.py

看到 Running on http://127.0.0.1:5113 就成了;停止按 Ctrl+C。

终端运行与 PyCharm 运行面板的区别:终端里 Ctrl+C 停,运行面板点红方块停
路径要写对:PyCharm 的终端默认在项目上一级目录(01_python_web_1061100024)。所以在根目录先 cd "03_practicum_labs",再进 lab;在 lab 里回退到 venv 用 ..\.venv。

二、运行、停止、重跑

操作怎么做说明
运行当前文件Ctrl+Shift+F10 或点绿三角只需打开 app.py,什么都不用配
重跑运行面板左边绿色 ↻改完代码 debug 会自动重载,一般不用手动重跑
停止运行面板红色 ■不点它,端口就一直被占着,下次会报 Address already in use
换个端口改 app.py 最后一行 port=5113每个 lab 端口不同,见首页卡片
看运行配置顶部中间下拉框(如 lab04_jinja2_templates(5113))点它可以切换/编辑配置,里面有环境变量一项

三、解释器、环境变量、装包

配解释器(新电脑只做一次)

  1. File → Settings(Ctrl+Alt+S)→ Project → Python Interpreter
  2. 右上齿轮 → Add Interpreter → Add Local Interpreter
  3. 选 Select existing → 填 <项目>\.venv\Scripts\python.exe → OK
① 打开项目先看有没有黄条
② 设置页:Python 解释器,右上「添加解释器」
③ 配好后:黄条消失、绿三角可点、右下角显示解释器名

装包(缺什么装什么)

设置 → Python 解释器 → 包列表下方的 + → 搜包名 → Install;或在终端里 .venv\Scripts\python.exe -m pip install flask-login。

环境变量(Run → Edit Configurations)

  1. 顶部运行配置下拉 → Edit Configurations…
  2. 选中本 lab 的配置 → 找到 Environment variables 一栏 → 点右侧图标
  3. 点 + 加一行,如 PYTHONIOENCODING=utf-8 → OK
本课程的工程已经把编码写进代码里,一般不需要动环境变量;只有当你的电脑终端中文乱码、或要让程序读某个密钥时才用得上。

四、报错时怎么做(真机截图)

下面这些是真实跑出来的,每个 lab 手册第六节里还有各自的报错案例。

no such table: students —— 没建表就查
UndefinedError —— 模板用了没传的变量
蓝图没注册 —— /about 404
缺 user_loader —— 一登录就崩