web.py:一个简单到极致的 Python Web 框架
在 Python Web 框架的版图里,Django 和 Flask 占据了大部分注意力。前者功能齐全但体量庞大,后者轻量但写起中型项目来还是需要不少样板代码。web.py 走的是第三条路:用最少的代码解决最核心的问题。

web.py 最初由 Aaron Swartz 开发,这位 Reddit 联合创始人和 RSS 规范作者用这个框架搭建了 Reddit 的早期版本。一个支撑过 Reddit 的框架,核心代码却小到可以通读一遍,这本身就是它设计哲学的最好证明。Aaron Swartz 在 2013 年去世后,框架由社区接手维护,目前托管在 webpy 组织下,持续发布新版本并支持 Python 3.x。截至当前,项目在 GitHub 上获得了超过 5800 个 star。
web.py 的设计思路非常直白:URL 映射到类,类方法映射到 HTTP 动词。一个完整的 Web 应用可以写在一个文件里:
python
import web
urls = ('/', 'index')
class index:
def GET(self):
return "Hello, world!"
if __name__ == "__main__":
app = web.application(urls, globals())
app.run()
十行代码,一个可运行的 Web 服务就起来了。路由、请求处理、响应返回,三个概念各占两行,没有装饰器,没有工厂函数,没有 context manager。对于刚从 CGI 时代过来的人,这种写法几乎不需要任何心智负担。
web.py 内置了数据库抽象层,用 web.database 可以直连 SQLite、MySQL、PostgreSQL。查询结果直接返回 Storage 对象,同时支持属性访问和字典访问两种方式:
python
db = web.database(dbn='sqlite', db='data.db')
results = db.select('users', where='age > $age', vars={'age': 25})
for row in results:
print(row.name, row.email)
模板引擎同样是内置的,语法接近 Python 原生的字符串格式化,不引入新的模板语言:
python
render = web.template.render('templates/')
print(render.hello(name="world"))
表单处理、Cookie、Session 这些 Web 开发中的高频需求,框架也都提供了简洁的 API。web.input() 一行拿到所有请求参数,web.setcookie() 一行设置 Cookie。没有复杂的中间件链,没有隐式的请求上下文,每个操作都是显式的、可预测的。调试时不需要在框架内部跳来跳去,因为框架的调用栈浅到一目了然。

web.py 的适用场景很明确:小到中型的 Web 服务、API 后端、原型验证、教学项目。它的学习曲线几乎是平的,看完官方教程就能上手写东西。对于想理解 Web 框架底层原理的新手,通读 web.py 的源码是一次高质量的实践,它用少量代码完整展示了一个 WSGI 框架该有的骨架。
框架安装同样简单:pip install web.py,一行命令即可开始使用。文档托管在 webpy.org,覆盖了从快速入门到部署的完整流程。社区规模适中,issue 和 PR 处理及时,是一个健康维护的开源项目。
web.py 的长久生命力来源于它始终坚持一个原则:Web 开发不应该复杂。这个原则可以从它的 API 数量、源码体积和文档长度中得到一致印证。在这个框架层出不穷的时代,这份克制反而成了一种难得的品质。