AI编程(七十四):Flask入门 — 给后厨装上”门牌号”

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 页面。

再把”点餐”的完整流程对回上节课的四步,你会发现只换了厨师,流程没变:

  1. 浏览器发请求:GET /hello;
  2. Flask 前台查登记表:”/hello 归 hello() 管”,把单子送过去;
  3. hello() 办事,返回文字;
  4. 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 页面太生硬——这种”用户视角挑刺”自己最难想到。

五、四个必踩的坑(先打疫苗)

  1. pip 不是内部或外部命令 / ModuleNotFoundError: No module named 'flask'。 八成是 pip 装的 Python 和你跑代码的 Python 不是同一个。疫苗:用 python -m pip install flask 装——前面的 python 是谁,装进谁的包里,永远不会错位。这招对任何第三方库都通用,今天记死。
  1. 改了代码,浏览器刷新还是旧的。 两种可能:要么没开 debug=True(得手动 Ctrl+C 停掉重跑),要么你刚加了一个新路由——热重载只”重新加载”已登记的,个别环境下新增路由也会失灵。疫苗:改完看一眼终端有没有 Restarting,没有就 Ctrl+C 重跑。记住口诀:改菜看火,不行就重开火。
  1. @app.route("hello") 少写开头的斜杠,或写成 @app.route("/hello/") 觉得跟 /hello 一样。 门牌号必须以 / 开头,/hello 和 /hello/ 严格说是两个门牌。疫苗:门牌一律以 / 开头、结尾不带斜杠;万一敲 /hello/ 也能访问你的 /hello,那是 Flask 的”宽容模式”,别依赖它,写法统一最省心。
  1. 把 里的尖括号写进网址。 新手真会去敲 http://127.0.0.1:5000/hello/,然后得到 404,来问我”占位符怎么不灵”。疫苗:尖括号只写在代码里,网址里放真实数据。/hello/ 是登记表上的”任意值”,客人敲的永远是 /hello/小明 这种具体地址。顺带一提:浏览器会把网址里的中文自动转码,你敲 /hello/小明 没问题,但 f"{name}" 拿到的可能被转过码,显示不对就让AI教你 unquote,不急,先跑通主线。

六、跟AI协作的正确姿势

  1. 加功能永远”一个路由一个函数”地加。 让 AI 给的代码块是”完整的新增函数”,而不是”在某函数里加三行”。路由的美就在于新增不动旧的——AI 给的方案如果让你改老代码,多半是它没吃透你的结构,把 app.py 全文发给它重来。
  1. 让AI给你出”路由设计题”。 比如”菜品详情页、搜索结果页、用户主页,各该用什么门牌”。路由设计是网站的地基,练的不是语法是拆分思维——什么该是一个门牌,什么该是一个门牌带参数。答完让AI按”网址是否可收藏、是否表达状态”两条标准批改。
  1. 报错截图整段终端给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 只管填数据。一个新概念,你的餐厅从此有正经菜单页。