本文介绍如何利用 python 内置模块快速启动一个轻量级 http 服务器，无需部署即可通过局域网在手机浏览器中访问本地网页项目，实现跨设备响应式调试。
本文介绍如何利用 python 内置模块快速启动一个轻量级 http 服务器，无需部署即可通过局域网在手机浏览器中访问本地网页项目，实现跨设备响应式调试。
Python 自带 http.server 模块，无需额外安装依赖，即可一键启动静态文件服务器，非常适合前端开发中的本地预览与多端联调（如用手机连接同一 Wi-Fi 访问 http://192.168.x.x:8000 查看响应式效果）。
✅ 基础服务器脚本（推荐用于 HTML/CSS/JS 项目）
将以下代码保存为 server.py，并确保它位于你网站项目的根目录（即包含 index.html 的文件夹中）：
import http.server
import socketserver
import os
PORT = 8000
# 可选：自动检测并切换到当前工作目录（增强鲁棒性）
os.chdir(os.path.dirname(os.path.abspath(__file__)))
Handler = http.server.SimpleHTTPRequestHandler
with socketserver.TCPServer(("", PORT), Handler) as httpd:
print(f"? 本地服务器已启动")
print(f"? 访问地址（电脑）: http://localhost:{PORT}")
print(f"? 局域网地址（手机）: http://<你的电脑IP>:{PORT}")
print("? 提示：在终端执行 'ipconfig'（Windows）或 'ifconfig'（macOS/Linux）查看本机 IPv4 地址")
try:
httpd.serve_forever()
except KeyboardInterrupt:
print("\n⏹️ 服务器已停止")? 模块说明
- http.server: Python 标准库中的 HTTP 服务模块，SimpleHTTPRequestHandler 能自动处理 .html、.css、.js、图片等静态资源的 GET 请求，并支持目录列表（若无 index.html）。
- socketserver: 提供通用 TCP/UDP 服务器框架；TCPServer 实现基于 TCP 的持久连接，稳定可靠。
- os（增强版中添加）：确保服务器始终在脚本所在目录提供服务，避免路径错误。
? 手机访问关键步骤
- 确认电脑与手机处于同一 Wi-Fi 网络；
-
查电脑 IP 地址：
- Windows：命令行运行 ipconfig → 查找 IPv4 地址（通常形如 192.168.1.5）；
- macOS/Linux：终端运行 ifconfig | grep "inet " | grep -v 127.0.0.1；
- 在手机浏览器中输入：http://192.168.1.5:8000（替换为你的实际 IP 和端口）；
- 即可实时预览并调试响应式布局。
⚠️ 注意事项
- 防火墙可能拦截外部访问：若手机无法连接，请临时关闭系统防火墙，或在防火墙设置中允许 Python 进程通过端口 8000；
- 默认仅服务当前目录及子目录，不支持跨目录访问（安全设计）；
- 不适用于需要后端逻辑（如 Flask/Django 路由、数据库交互）的场景——此时应改用对应框架的开发服务器；
- 如需 HTTPS 或更高级功能（如热重载、代理），建议后续迁移到 live-server（Node.js）或 http-server。
✅ 总结：该方案零依赖、开箱即用、安全可控，是前端开发者进行快速响应式验证的理想起点。
