- 后端
【免费下载链接】zero
Zero is a web server to simplify web development.
导读
本文深入讲解开源 Web 开发框架 Zero 的 Python 支持能力：开发者只需在项目目录中放置一个导出handler函数的.py文件，Zero 便会自动将其暴露为一个 HTTP API 端点，整个过程零配置、无需手写路由表。读完本文，你将掌握在 Zero 中编写 Python API 端点、返回 JSON、读取 URL 参数与 POST 表单数据、处理文件上传、借助requirements.txt自动安装第三方依赖、以及利用$前缀构建动态路由（Pretty URL Slugs）的完整实战技能，并了解其背后基于 Flask + Waitress + Node.js 反向代理的实现原理。
核心机制：文件即 API，handler函数即端点
Zero 允许你把每个 API 端点定义为独立文件中的独立函数，函数必须命名为handler。假设你的函数位于./api/process.py，它就会被暴露为http://<SERVER>/api/process。这是一个"约定优于配置"的设计：文件的相对路径决定 URL，函数名handler决定响应逻辑。
Zero 内部使用 Flask 作为 Python 运行引擎，因此你可以直接使用 Flask 生态中熟悉的jsonify、request等导入，无需额外学习新 API。
最小示例
# hello.py def handler(): return "Hello"上述文件导出了一个名为handler的函数。当你访问http://127.0.0.1:3000/hello时，Zero 会调用handler()，并将返回值发送回浏览器。
前置条件：使用 Zero 的 Python 功能前，必须先在系统中安装 Python 3（参见 官方下载页）。
打印到控制台：别忘了flush=True
在 Python 后端开发中，用print()调试是常见做法。但在 Zero 中，打印语句必须显式使用flush=True才能生效：
print("Hello", flush=True)原因在于：Zero 通过子进程方式运行 Python 服务（详见下文"实现原理"），输出流默认带缓冲，只有flush=True才能保证调试信息及时刷出到终端。
源码佐证
在 Zero 的测试目录中，test/www/python/basic.py 演示了在一个 JSON 响应端点内部调用辅助函数printMsg()，其中就使用了print("abc", flush=True)：
from flask import jsonify def handler(): arr = [1,2,3] printMsg() return jsonify( username="basic", email="a@h.com", arr=arr ) def printMsg(): print("abc", flush=True) return "Check your console"这印证了：handler并非必须孤军奋战，它可以调用同文件内的其他函数，只需保证入口函数名为handler即可。
返回 JSON 响应：使用 Flask 的jsonify
API 通常以 JSON 格式响应。Zero 内置的 Flask 运行时让你可以直接使用jsonify构造 JSON 响应：
from flask import jsonify def handler(): arr = [1, 2, 3] return jsonify( username="basic", email="a@h.com", arr=arr )访问对应 URL 时，浏览器会收到形如{"username": "basic", "email": "a@h.com", "arr": [1, 2, 3]}的标准 JSON。
源码佐证：集成测试验证
test/integration/page.python.js 中的集成测试证实了这一行为：
test("Basic JSON Response", () => { return get("/python/basic", { json: true }).then(data => { expect(data.username).toBe("basic"); }); });测试请求/python/basic端点并以 JSON 模式解析响应，断言data.username === "basic"，验证了 JSON 响应的端到端可用性。仓库中 test/www/python/withnumpy.py 还展示了在 JSON 响应中整合 NumPy 数组（np.array([2,3,5]).tolist()）的用法。
读取 URL 参数（Query String）
浏览器发送的查询参数（URL 中?id=1&...部分）可以在 Python 端点中通过 Flask 的request对象获取：
# hello.py from flask import request def handler(): name = request.args.get('name') return "Hello, " + name访问http://127.0.0.1:3000/hello?name=luke将输出Hello, luke。
源码佐证
test/www/python/queryparam.py 与该示例一致，test/integration/page.python.js 通过get("/python/queryparam?name=asad")断言响应为"Hello, asad"。
自动安装依赖：requirements.txt即依赖清单
Zero 可以利用pip自动安装项目依赖。只需在项目根目录放置一个requirements.txt文件：
numpy==1.15.0 pandas==0.20.3仓库测试项目中真实存在的 test/www/requirements.txt 内容为numpy==1.15.0，对应的 test/www/python/withnumpy.py 在端点中成功import numpy as np并返回 NumPy 计算结果，其集成测试 test/integration/page.python.js 断言data.msg === "numpy"。
实现原理：firstrun 合并依赖并自动安装
依赖安装由 packages/handler-python/firstrun.js 在构建阶段完成，要点如下：
- Zero 会将
flask==1.1.1和waitress==1.4.3这两个运行基础依赖自动写入合并后的requirements.txt； - 若项目根目录已有
requirements.txt，其内容会被追加进合并文件； - 随后按行去重并过滤空行，再调用
pip install -r <合并后的requirements.txt>完成安装； - 如果系统中没有
pip，packages/handler-python/installPip.js 会先从https://bootstrap.pypa.io/get-pip.py下载get-pip.py并执行python get-pip.py --user自动安装 pip（优先探测pip3/pip，也支持python -m pip）。
该 firstrun 流程由构建清单 packages/core/lib/manifest/buildManifest.js 触发：每当扫描到项目中的.py文件时，会执行一次 python firstrun（整个生命周期只执行一次）。
动态路由（Pretty URL Slugs）：$前缀定义参数
Zero 根据文件结构决定路由。对于/user/luke、/user/anakin这类动态路径，其中luke、anakin是参数，Zero原生支持：任何以$开头的文件或文件夹都被视为动态路由。
单层动态参数
创建./user/$username.py，浏览器访问/user/luke时，Zero 将请求路由到$username.py，且你的handler应接收一个username参数：
# project/ # └── user/ # └── $username.py <- this file def handler(username): return "Hello, " + username动态文件夹 + 多层嵌套
参数同样适用于文件夹名。若想服务/user/luke/messages这样的路由，可以用如下目录结构：
project/ └── user/ └── $username/ └── index.py └── messages.pyindex.py处理/user/:username路由；messages.py处理/user/:username/messages路由。
你还可以组合多层动态路径，例如/user/:username/:commentId，对应./user/$username/$commentId目录下的处理文件：
def handler(username, commentId): return username + " says: " + getComment(commentId)实操提醒：Bash 中必须转义$
$在 Bash 中是变量符号，直接执行cd $username或mkdir $username可能什么都不会发生（被当成变量展开）。正确做法是对$进行转义：
cd \$username mkdir \$username源码佐证：$param到 Flask 路由的转换
动态参数的底层转换发生在 packages/handler-python/handler.js：Zero 会把页面路径中所有以$开头的段改写为 Flask 的<param>语法，再交给 Python 子进程注册路由：
// change basePath $params format to flask's format: <param> var basePath = pageData.path .split("/") .map(p => { if (p.startsWith("$")) return "<" + p.slice(1) + ">"; return p; }) .join("/");同时，构建清单 packages/core/lib/manifest/buildManifest.js 在生成 URL 路径时会保留$param名称的大小写（普通路径段则转为小写），保证参数名在 URL 与 handler 签名之间一一对应。测试目录 test/www/dynamicpaths/nonparam/$nestedParam.py 正是这一机制的样例：handler 接收nestedParam参数并回显为 JSON。
接收 POST 数据（HTML 表单）
下面示例展示如何在 Python 端点中获取 HTML 表单提交的 POST 数据：
# login.py from flask import request def handler(): if request.method == 'POST': email = request.form.get('email') password = request.form.get('password') if password == "secretpassword": return "Success" return "Failed"配套的 HTML 表单：
<!-- index.html --> <html> <body> <form action="/login" method="POST"> <input type="email" name="email" /> <input type="password" name="password" /> <input type="submit" /> </form> </body> </html>源码佐证
test/www/python/postdata.py 与 test/www/python/postdataform.html 是仓库中的真实对应物（form 的action指向/python/postdata）。集成测试 test/integration/page.python.js 以POST方式提交email与password表单字段，并断言响应为Got email@domain.com。
处理文件上传
Zero 的 Python 端点同样支持文件上传，核心是基于 Werkzeug（Flask 依赖的底层 WSGI 工具集）的secure_filename做安全文件名处理：
# upload.py from flask import request from werkzeug import secure_filename def handler(): if request.method == 'POST': f = request.files['file'] f.save(secure_filename(f.filename)) return 'file uploaded successfully'配套的上传表单（注意必须设置enctype="multipart/form-data"）：
<!-- index.html --> <html> <body> <form action="/upload" method="POST" enctype="multipart/form-data"> <input type="file" name="file" /> <input type="submit" /> </form> </body> </html>源码佐证
test/www/python/upload.py 与 test/www/python/uploadform.html 即为该功能的仓库实现样例（form 的action指向/python/upload）。
进阶：Python 端点如何被"零配置"地托管与代理
理解以下几点，有助于在生产环境中排查问题：
- 识别与构建：Zero 通过 packages/core/lib/utils/fileToPageType.js 将
.py扩展名映射为page:python类型；对应处理器由 packages/handler-python/index.js 注册（process指向handler.js，firstrun负责依赖安装）。 - Python 解释器探测：packages/handler-python/pythonExe.js 会依次探测
python3、python、Windows 下的py，并支持通过环境变量PYTHONBIN强制指定解释器路径；找不到解释器时会抛出明确错误提示安装 Python 3。 - 子进程 + 动态端口 + 反向代理：packages/handler-python/handler.js 以子进程方式运行
entryfile.py；packages/handler-python/entryfile.py 内部创建 Flask 应用、加载目标模块并调用module.handler(*args, **kwargs)，随后通过waitress.serve监听一个动态获取的本地空闲端口，并把端口号通过 IPC 通道回报给 Node 进程；最后 packages/handler-python/expressWrap.js 用 Express 建立一个对所有路径生效的透明反向代理（保留原始请求方法与头信息，转发状态码、响应头并流式回传响应体）。 - 工作目录（CWD）：子进程的
cwd被设置为端点文件所在目录（见 handler.js），因此端点的相对文件操作基于其自身目录生效。测试 test/www/python/cwd.py 通过读取同目录下的text.txt验证了这一点，test/integration/page.python.js 断言其返回值为文件内容。 - 相对导入：entryfile.py 会把端点文件所在目录追加进
sys.path，从而支持端点间的相对导入——test/www/python/nestedimport.py 从同级模块basic导入handler并转发调用，集成测试 test/integration/page.python.js 验证其返回与/python/basic相同的 JSON 结构。
小结
在 Zero 中编写 Python API 的完整工作流可归纳为：新建.py文件 → 定义handler函数 → 用 Flask 的request/jsonify处理输入输出 → （可选）在项目根目录添加requirements.txt声明第三方依赖 → 访问由文件路径决定的 URL。动态路由使用$前缀并注意在 Bash 中转义，所有请求/响应、依赖安装、端口分配均由 Zero 内部基于 Flask + Waitress 与 Node.js 反向代理自动完成，让开发者专注于纯粹的业务函数编写。
相关测试与示例源码可进一步参考：test/www/python 目录下的端点样例、test/integration/page.python.js 集成测试，以及 examples/basic-login-nodejs 等示例项目。
- 后端
【免费下载链接】zero
Zero is a web server to simplify web development.
相关推荐
Agent Zero 后端扩展点体系完全指南：基于 extensions/python 的生命周期钩子与自定义开发
Agent Zero 后端扩展点体系完全指南：基于 extensions/python 的生命周期钩子与自定义开发 Agent Zero 框架将 Agent 的
人工智能大模型AI AgentAgent 框架自主智能体多智能体工具调用MCP 服务浏览器控制React Styleguidist 自定义 Express 端点（configureServer）实战：为组件示例提供后端 API
React Styleguidist 自定义 Express 端点（configureServer）实战：为组件示例提供后端 API 导读 本篇文章以 Reac
开发工具前端2025 JavaScript全栈开发指南：从前端框架到后端架构的实战路径
2025 JavaScript全栈开发指南：从前端框架到后端架构的实战路径 JavaScript全栈开发已成为现代Web开发的核心技能，它让开发者能够使用单一语
文档
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
