怎样运用Python启动index.html_简易服务器运行index.html

作者：袖梨 2026-07-27

Python自带http.server模块可快速启动本地HTTP服务器，命令为python -m http.server 8000，需确保index.html在当前目录，访问http://localhost:8000即可正确加载JS/CSS等资源，避免file://协议因跨域限制导致失败。

Python 自带的 http.server 模块能快速启动一个本地 HTTP 服务器来打开 index.html，但直接双击或用浏览器打开 file:// 协议会因跨域、路径解析等问题导致 JS/CSS 加载失败——必须走 http:// 才行。

用 `python -m http.server` 启动静态服务器

这是最轻量、无需安装依赖的方式，适用于 Python 3.7+。关键点不是“运行 HTML”，而是让当前目录（含 index.html）成为 Web 根目录：

确保 index.html 在你当前终端所在目录下（可用 ls index.html 或 dir index.html 确认）
执行命令：python -m http.server 8000（端口可换，如 3000、8080）
浏览器访问 http://localhost:8000 ——它会自动查找并显示 index.html（因为该模块默认支持 index.html 作为目录索引）
如果页面 404，大概率是终端没在 index.html 所在目录，或文件名拼错（注意大小写、下划线是否一致）

为什么不能用 `webbrowser.open("index.html")`

这个调用走的是 file:// 协议，浏览器会禁用 fetch、XMLHttpRequest、import（ESM）、甚至部分 localStorage 权限，尤其当你页面里有 ./data.json 或 import './utils.js' 时，控制台直接报 CORS 错误或 404。

webbrowser.open("index.html") 是本地文件浏览，不是 Web 服务
http.server 提供真实 HTTP 响应头（如 Content-Type: text/html），JS/CSS/JSON 才能被正确加载和解析
开发阶段若依赖 localhost 白名单（如 OAuth 回调、某些 API SDK），file:// 完全不满足条件

遇到 `Address already in use` 怎么办

端口被占是常见问题，错误信息就是 OSError: [Errno 48] Address already in use（macOS/Linux）或 [WinError 10013]（Windows）：

立即学习“Python免费学习笔记（深入）”；

换端口：比如改用 python -m http.server 8080
查占用进程：lsof -i :8000（macOS/Linux）或 netstat -ano | findstr :8000（Windows），再 kill -9 PID 或任务管理器结束
Windows 用户有时需管理员权限才能绑定低端口（如 80），建议避开 1–1023 范围