Python 快速搭建简单 HTTP 服务器方法

Python 内置的 `http.server` 模块提供了一种零依赖、秒级启动静态文件服务器的极简方案——只需一条命令 `python -m http.server 8000`，就能在本地快速预览网页、调试前端或临时共享文件；它还支持通过自定义处理器轻松扩展功能（如添加 `/health` 健康检查接口），虽仅限开发测试使用（不支持 HTTPS、高并发或生产级安全特性），却以“够用、够快、够轻”的特质成为开发者手边最趁手的临时工具，真正实现“想看即看，改完即测”。

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 脚本：

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 已经足够快、够稳、够简单。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~