Web入门第二课。上节课的小厨房接单全靠 if 判断,客人多一个就多写一个分支。今天只引入一个新概念:路由(Route)——在门口挂一排门牌号,客人报门牌号,单子自动送到对应灶台。Flask 是 Python 世界里最轻的”后厨框架”,二十行代码开一家正经餐厅。
一、真实场景:为什么医院门诊要分诊台
先想一个你见过无数次的场景:去医院挂号,挂号窗口不是直接让你进诊室,而是给你一张单子——”内科在2楼201,化验在1楼105,缴费在1楼102″。你拿着单子,走到对应门牌号的房间,找对了医生。
为什么不搞一个大房间,所有病人全进来,医生在里面喊”骨折的站左边、感冒的站右边”?因为人一多就乱套:分诊靠喊,排队没秩序,医生记不住谁是谁。
上节课的 tiny_site.py 就是那个”大房间”。回看它的接单逻辑:
if self.path == "/menu":
...
elif self.path.startswith("/price"):
...
elif self.path.startswith("/total"):
...
三个门牌就写了三个分支。要是开一家”正经餐厅”——菜单、下单、查订单、个人中心、登录——就是十几二十个分支,一个 if 长城,加一道菜就得在长城上凿个洞,改错了整个程序全崩。
路由就是解决这个的:把”哪个门牌号归哪个灶台管”提前登记好,客人来了按门牌自动分流,不用 if 长城。这就是今天要学的全部新东西。别小看它,你后面写的每一个网站(包括第84课的记账网站)都是从”登记路由”开始的。
二、新概念:路由 = 门牌号登记表
路由(Route),说白了就是一张登记表:”网址的哪一段,交给哪个函数处理”。
拿餐厅打比方:
| 医院/餐厅 | Flask 里 | 大白话 |
|---|
|——|——|——–|
| 门牌号 “201” | /hello 这样的网址 |
客人报的地址 |
|---|---|---|
| 分诊台 | Flask 框架本身 | 负责听门口、查登记表、把人领对屋 |
| 201 的医生 | def hello(): 这个函数 |
真正给客人办事的人 |
| 登记行为 | @app.route("/hello") |
在登记表上写一行:”这个门牌归这个函数” |
Flask 是一个现成的 Python 框架(框架 = 别人写好的半成品,你往上填自己的逻辑)。它替你干了上节课最烦人的三件事:监听端口收请求、解析网址、把响应发回去。你只管两件事:登记路由、写处理函数。
上节课那句老话换个说法:上节课你亲手造了收发室,这节课直接雇了个专业前台。
用 Flask 写”接单”长这样,先混个眼熟,一会儿就动手跑:
from flask import Flask
app = Flask(__name__) # 开一家店
@app.route("/hello") # 登记:门牌 /hello 归下面这个函数管
def hello():
return "你好,欢迎光临!" # 这个函数返回什么,客人就看到什么
两个语法糖,拆开看:
@app.route("/hello")这种@开头的写法叫装饰器,你可以先把它当成”贴在函数门口的门牌”。它一贴,Flask 就把/hello和下面的函数绑定了。不用纠结原理,会贴就行。return "..."——处理函数返回什么,浏览器就收到什么。今天先返回纯文字,下节课开始返回正经 HTML 页面。
再把”点餐”的完整流程对回上节课的四步,你会发现只换了厨师,流程没变:
- 浏览器发请求:
GET /hello; - Flask 前台查登记表:”
/hello归hello()管”,把单子送过去; hello()办事,返回文字;- Flask 把文字打包成响应,送回浏览器。
上节课讲的请求、响应、状态码,一个没变——Flask 变的是”后厨内部怎么分工”,不是点餐规矩。
三、动手:二十行开一家正经餐厅
第 1 步:雇前台 —— 安装 Flask
上节课用的是 Python 自带库,今天第一次要装第三方库。终端里执行:
pip install flask
一行命令,等它跑完(看到 Successfully installed flask 字样)。装一次就永久可用,后面十几课天天用它。
第 2 步:写登记表 —— app.py
新建 app.py,照抄:
from flask import Flask
app = Flask(__name__) # 开店:创建一个 Flask 应用
@app.route("/") # 门牌 "/" = 客人只敲门没报房号(首页)
def index():
return "欢迎来到我的餐厅!菜单在 /menu,今日特价在 /today"
@app.route("/menu") # 门牌 /menu = 菜单
def menu():
return "麻辣烫 28元 | 蛋炒饭 15元 | 酸梅汤 6元"
@app.route("/today") # 门牌 /today = 今日特价
def today():
return "今日特价:麻辣烫第二份半价!"
@app.route("/hello/") # 门牌带名字:/hello/小明 /hello/小红
def hello(name):
return f"{name},你的菜来啦!"
if __name__ == "__main__":
app.run(debug=True) # 开火营业
逐块看两眼:
- 门牌
/是根路径——客人只敲门没报房号时到的地方,等同于首页; /hello/是今天唯一值得多看一眼的写法:尖括号是”占位符”,客人敲/hello/小明,name就自动等于"小明",一个路由吃下无数个网址。这是”登记表”比 if 长城强的第二个地方——if 长城可写不出”匹配任意名字”的分支;app.run(debug=True)的debug=True先照抄,坑点里细说。
第 3 步:开火 —— 跑起来看看
终端里:
python app.py
看到这坨输出就是开火成功:
* Running on http://127.0.0.1:5000
注意端口变了:上节课是 8000,Flask 默认 5000。打开浏览器,挨个敲:
http://127.0.0.1:5000/→ 欢迎来到我的餐厅!……http://127.0.0.1:5000/menu→ 麻辣烫 28元 | ……http://127.0.0.1:5000/today→ 今日特价……http://127.0.0.1:5000/hello/小明→ 小明,你的菜来啦!http://127.0.0.1:5000/abc→Not Found(404!上节课学的状态码,Flask 自动给你发——门牌没登记,前台直接说”没这屋”,不用你写一行代码)
对比一下:上节课三个接口写了六十行,这节课四个接口(还带一个”任意名字”的)二十行,而且加接口只需要再加一个函数,不用动任何已有代码。这就是框架的价值:它管收发,你管业务。
第 4 步:改菜 —— 体验 debug 热重载
保持程序运行,把 today() 里的特价改成”酸梅汤买一送一”,保存。盯着终端看一眼——它会自己刷一行 Detected change, restarting。回到浏览器直接刷新,特价已经变了,不用停程序、不用重启。
这个体验叫热重载,是 debug=True 送的。写网站没有它,你每改一个字都要重启一次,改十次就疯了。
四、跟AI说需求:让AI当你的”路由规划师”
今天的”跟AI说需求”来一发实战的——给餐厅扩张,让AI帮你规划:
“我在用 Flask 学路由。我的餐厅目前有 /menu、/today、/hello/ 三个路由。我想加一个’查订单’功能:客人访问 /order/1001 能看到订单号1001的状态。请先给我讲清楚:①这个路由该怎么写、 拿到的是什么类型;②如果我想让 /order/1001 和 /order/1002 走同一个函数,路由怎么设计;③我改完代码浏览器里没变化,可能漏了什么。讲完给一段能直接跑的代码,我跑通了你再给我出一道路由设计题考我。”
这个问法的心机,照抄:
- 带着你现有的代码问——AI 给的方案直接嵌进你的餐厅,不是空对空的模板;
- 要求”先讲为什么再给代码”——防止 AI 直接甩答案,你看不懂也不敢改。看懂再抄,是”跟AI说需求→读懂→改进”的底线;
- 让它出题考你——路由设计有个常见的坑:什么该用
/order/、什么该用查询参数?id=1001。让AI出题对比考你,比自己死记硬背强十倍。
进阶玩法:把你的 app.py 整个发给AI,说”假装你是美食博主来点单,把每个门牌都敲一遍,挑出体验不好的地方”。AI 会发现你首页没写清楚有什么、404 页面太生硬——这种”用户视角挑刺”自己最难想到。
五、四个必踩的坑(先打疫苗)
pip不是内部或外部命令 /ModuleNotFoundError: No module named 'flask'。 八成是 pip 装的 Python 和你跑代码的 Python 不是同一个。疫苗:用python -m pip install flask装——前面的python是谁,装进谁的包里,永远不会错位。这招对任何第三方库都通用,今天记死。
- 改了代码,浏览器刷新还是旧的。 两种可能:要么没开
debug=True(得手动 Ctrl+C 停掉重跑),要么你刚加了一个新路由——热重载只”重新加载”已登记的,个别环境下新增路由也会失灵。疫苗:改完看一眼终端有没有Restarting,没有就 Ctrl+C 重跑。记住口诀:改菜看火,不行就重开火。
@app.route("hello")少写开头的斜杠,或写成@app.route("/hello/")觉得跟/hello一样。 门牌号必须以/开头,/hello和/hello/严格说是两个门牌。疫苗:门牌一律以/开头、结尾不带斜杠;万一敲/hello/也能访问你的/hello,那是 Flask 的”宽容模式”,别依赖它,写法统一最省心。
- 把
里的尖括号写进网址。 新手真会去敲http://127.0.0.1:5000/hello/,然后得到 404,来问我”占位符怎么不灵”。疫苗:尖括号只写在代码里,网址里放真实数据。/hello/是登记表上的”任意值”,客人敲的永远是/hello/小明这种具体地址。顺带一提:浏览器会把网址里的中文自动转码,你敲/hello/小明没问题,但f"{name}"拿到的可能被转过码,显示不对就让AI教你unquote,不急,先跑通主线。
六、跟AI协作的正确姿势
- 加功能永远”一个路由一个函数”地加。 让 AI 给的代码块是”完整的新增函数”,而不是”在某函数里加三行”。路由的美就在于新增不动旧的——AI 给的方案如果让你改老代码,多半是它没吃透你的结构,把 app.py 全文发给它重来。
- 让AI给你出”路由设计题”。 比如”菜品详情页、搜索结果页、用户主页,各该用什么门牌”。路由设计是网站的地基,练的不是语法是拆分思维——什么该是一个门牌,什么该是一个门牌带参数。答完让AI按”网址是否可收藏、是否表达状态”两条标准批改。
- 报错截图整段终端给AI。 Flask 的报错在
debug=True下是黄底网页,信息很全但吓人。把网页上Traceback整段复制给AI,别只说”报错了”。你可以说:”这是我的 app.py 和报错全文,先告诉我错在第几行、属于路由没登记还是函数写错,再给改法。”——先定位再修,是调试的正确顺序。
七、今日小练习
练习1:给餐厅加两个门牌。 加 /hours(营业时间)和 /chef(主厨介绍),再加一个 /say/,让浏览器访问 /say/你好 时显示”厨师对你说:你好”(提示:照着 @app.route("/today") 的格式再贴两个”门牌”,/say/ 照抄 /hello/ 的写法换个变量名就行;别忘了新函数名不能和旧的重名——登记表上一个函数名就是一个医生,重名就串岗了)。
练习2:把上节课的搬进 Flask。 上节课 tiny_site.py 里有个 /price?x=麻辣烫 查价格的功能。用 Flask 重写它:建一个 PRICES 字典(麻辣烫28、蛋炒饭15、酸梅汤6),路由用 /price/(提示:return f"{dish}:{PRICES[dish]}元",想想如果客人敲 /price/汉堡——字典里没有的菜——程序会怎样?这是个坑,先跑跑看,下节课专门治它)。
练习3:跟AI玩一轮”门牌设计赛”。 给AI出题:”我要开一家奶茶店网站,有看菜单、下订单、查订单、联系我们四个功能,帮我设计四个路由的门牌,说清每个为什么这么设计。”AI答完你按两条标准挑刺:门牌是不是一看就懂、带参数的门牌是不是把”变化的部分”放进了尖括号(提示:/order/ 比 /order?id=xxx 友好,因为网址本身就是一句人话;你能挑出AI的刺,就说明路由学到位了)。
下篇预告
下一篇(第75篇):HTML模板 — 让”欢迎光临”变成真正的网页。 今天 return 的还是纯文字,浏览器显示出来素得像记事本。菜要配摆盘——render_template:把 HTML 写在单独的模板文件里,Python 只管填数据。一个新概念,你的餐厅从此有正经菜单页。