web.py：一个简单到极致的 Python Web 框架

文章目录

[web.py：一个简单到极致的 Python Web 框架](#web.py：一个简单到极致的 Python Web 框架)

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 数量、源码体积和文档长度中得到一致印证。在这个框架层出不穷的时代，这份克制反而成了一种难得的品质。

I 数量、源码体积和文档长度中得到一致印证。在这个框架层出不穷的时代，这份克制反而成了一种难得的品质。