Python 自带 http.server 模块可快速启动静态文件服务器:命令行执行 python -m http.server 8000 即可访问目录列表;支持自定义处理器添加路由(如 /health);仅限开发测试,不适用于生产环境。

Python 自带 http.server 模块,无需安装第三方库,几行命令就能启动一个基础 HTTP 服务器,适合快速预览静态文件、本地调试或临时共享资源。
用命令行一键启动(最简单)
在终端中进入目标目录,执行对应命令即可:
- Python 3.x:
python -m http.server 8000(默认端口 8000,可改) - Python 2.x(已停用):
python -m SimpleHTTPServer 8000
启动后访问 http://localhost:8000 就能看到当前目录的文件列表,点击即可下载或查看 HTML/CSS/JS 等静态内容。
用脚本自定义服务器行为
如果需要控制响应头、处理特定路径或添加日志,可写一个 Python 脚本:
立即学习“Python免费学习笔记(深入)”;
1、数据调用该功能使界面与程序分离实施变得更加容易,美工无需任何编程基础即可完成数据调用操作。2、交互设计该功能可以方便的为栏目提供个性化性息功能及交互功能,为产品栏目添加产品颜色尺寸等属性或简单的留言和订单功能无需另外开发模块。3、静态生成触发式静态生成。4、友好URL设置网页路径变得更加友好5、多语言设计1)UTF8国际编码; 2)理论上可以承担一个任意多语言的网站版本。6、缓存机制减轻服务器
from http.server import HTTPServer, SimpleHTTPRequestHandler
class MyHandler(SimpleHTTPRequestHandler):
def do_GET(self):
if self.path == '/health':
self.send_response(200)
self.send_header('Content-type', 'text/plain')
self.end_headers()
self.wfile.write(b'OK')
else:
super().do_GET()
if __name__ == '__main__':
server = HTTPServer(('localhost', 8000), MyHandler)
print("Serving on http://localhost:8000")
server.serve_forever()
这段代码让 /health 返回纯文本 "OK",其余路径仍按默认方式提供文件服务。
注意事项和常见问题
这个服务器仅用于开发和测试,不适用于生产环境:
- 不支持 HTTPS、并发连接少、无身份验证、无缓存控制
- 默认只服务当前工作目录及子目录,无法跨目录访问(安全限制)
- 若端口被占用,会报错
Address already in use,换端口重试即可,如8001 - Windows 用户注意关闭防火墙提示,Mac/Linux 用户可能需授权终端访问网络
想支持更多功能怎么办?
如需路由、模板、表单处理或 REST 接口,推荐使用成熟框架:
- Flask:轻量易上手,适合小项目和 API
- FastAPI:高性能,自动生文档,适合现代 Web 服务
- httpx + uvicorn(搭配 FastAPI):异步支持好,启动快
但对“立刻看个 HTML 页面”这种需求,http.server 已经足够快、够稳、够简单。









