本文介绍如何利用 python 内置模块快速启动一个轻量级 http 服务器，无需部署即可通过局域网在手机浏览器中访问本地项目，实现响应式设计的实时真机调试。
本文介绍如何利用 python 内置模块快速启动一个轻量级 http 服务器，无需部署即可通过局域网在手机浏览器中访问本地项目，实现响应式设计的实时真机调试。
在前端开发中，为验证网页在手机端的响应式表现，常需在真实移动设备上预览效果。与其反复上传至远程服务器，更高效的方式是将本地项目目录作为静态资源根目录，启动一个临时 HTTP 服务，并通过同一 Wi-Fi 网络让手机访问——Python 提供了开箱即用的解决方案。
✅ 核心脚本（兼容 Python 3.7+）
将以下代码保存为 server.py（建议放在你的网站项目根目录下）：
import http.server
import socketserver
PORT = 8000
Handler = http.server.SimpleHTTPRequestHandler
with socketserver.TCPServer(("", PORT), Handler) as httpd:
print(f"✅ 本地服务器已启动")
print(f"? 访问地址：http://localhost:{PORT}")
print(f"? 手机访问：http://{get_local_ip()}:{PORT}（见下方获取方法）")
try:
httpd.serve_forever()
except KeyboardInterrupt:
print("\n⏹️ 服务器已停止")? 增强版提示：如需自动显示本机局域网 IP（便于手机输入），可添加如下辅助函数（需额外导入 socket）：
import socket def get_local_ip(): try: s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM) s.connect(("8.8.8.8", 80)) ip = s.getsockname()[0] s.close() return ip except Exception: return "127.0.0.1"
? 模块说明
- http.server：Python 标准库中的 HTTP 服务器模块，SimpleHTTPRequestHandler 可直接提供静态文件服务（支持 HTML/CSS/JS/图片等），无需安装任何第三方包。
- socketserver：用于创建网络服务器框架，TCPServer 实现基于 TCP 的监听，("", PORT) 表示监听所有可用网络接口（包括局域网 IP），而不仅是 localhost。
? 手机访问关键步骤
- 确保电脑与手机连接同一 Wi-Fi 网络；
- 运行 python server.py，终端会输出类似 http://192.168.1.5:8000 的局域网地址；
- 在手机浏览器中输入该地址（如 http://192.168.1.5:8000），即可加载你的网页；
- 支持刷新、路由跳转（HTML5 History API 需配合 --bind-all 或自定义 handler，基础静态页完全可用）。
⚠️ 注意事项
- 防火墙可能拦截外部访问：Windows/macOS 用户首次运行时请允许“Python”通过防火墙；
- 若端口被占用，可修改 PORT = 8000 为其他值（如 3000、8080）；
- 此服务器仅适用于开发测试，不支持 HTTPS、用户认证或高并发，切勿用于生产环境；
- 项目目录中若含 index.html，将自动作为首页；否则会列出目录文件（可点击进入）。
✅ 总结
只需一个不到 10 行的 Python 脚本，你就能摆脱上传依赖，在秒级内开启跨设备调试通道。它轻量、可靠、零依赖，是前端开发者本地联调的必备技能。现在就打开终端，执行 python server.py，拿起手机扫码或手动输入地址——你的响应式页面，已在掌中实时呈现。
立即学习“Python免费学习笔记（深入）”；
