不用安装额外软件:用 Python 一条命令预览本地网页

举报
AiGuoHou 发表于 2026/11/19 10:34:23 2026/11/19
【摘要】 写好了 HTML 页面,却遇到路径、样式或资源加载问题?不妨试试 Python 自带的本地网页服务器。只需一条命令,就能把电脑上的文件夹变成一个简单的网站,方便预览网页、测试页面和查看静态资源。

做网页练习时,我们经常直接双击 index.html,让浏览器打开文件。这种方式虽然简单,但页面地址会以 file:// 开头,一些依赖 HTTP 请求、模块加载或相对路径的功能可能无法正常工作。

其实,不需要安装复杂的软件,也不需要购买服务器。利用 Python 自带的 http.server 模块,就能快速搭建一个只供本机访问的临时网页服务器。

一、先确认 Python 是否已经安装

打开电脑上的终端或命令提示符,输入:

python --version

如果系统提示找不到命令,可以试试:

python3 --version

Windows 用户还可以尝试:

py --version

只要能够正常显示 Python 版本号,就可以继续操作。如果以上命令都不可用,则需要先安装 Python,并根据安装程序的提示配置环境变量。

二、准备一个网页文件夹

首先,在电脑上创建一个文件夹,例如:

my-site/
├── index.html
├── style.css
└── images/
    └── photo.jpg

其中,index.html 是网页首页,style.css 用于控制页面样式,images 文件夹用于存放图片。

如果暂时没有网页文件,可以用任意文本编辑器新建一个 index.html,输入下面这段简单代码:

<!doctype html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>本地网页预览</title>
</head>
<body>
  <h1>你好,网页!</h1>
  <p>这是我的第一个本地站点。</p>
</body>
</html>

保存文件。注意检查扩展名,确保文件名是 index.html,而不是意外保存成 index.html.txt。

三、启动本地网页服务器

打开终端,进入刚才创建的 my-site 文件夹,然后执行:

python -m http.server 8000 --bind 127.0.0.1

如果使用的是 python3 或 Windows 的 py 命令,只需替换开头即可,例如:

python3 -m http.server 8000 --bind 127.0.0.1

如果看到类似下面的提示,就说明服务器已经成功启动:

Serving HTTP on 127.0.0.1 port 8000

接下来,保持终端窗口运行,打开浏览器,在地址栏输入:

http://127.0.0.1:8000/

浏览器就会显示当前文件夹中的文件列表。

点击 index.html,或者直接访问:

http://127.0.0.1:8000/index.html

就能看到刚才编写的网页。

以后修改 HTML、CSS 或 JavaScript 文件,只需保存,然后刷新浏览器,就能看到最新效果。

四、几个实用的小技巧

掌握基本用法后,还可以利用几个参数提高效率。

1. 更换端口

默认使用 8000 端口。如果这个端口已经被其他程序占用,可以换成 8001:

python -m http.server 8001 --bind 127.0.0.1

浏览器地址也需要相应修改为:

http://127.0.0.1:8001/

2. 指定网页文件夹

如果不想先切换到网页目录,可以通过 --directory 指定要访问的文件夹:

python -m http.server 8000 --bind 127.0.0.1 --directory ./my-site

这样就可以从当前终端所在位置直接启动指定目录的网页服务。

3. 停止服务器

使用完毕后,回到运行服务器的终端窗口,按下:

Ctrl + C

服务器就会停止运行。注意,关闭浏览器标签页并不会自动关闭服务器。

五、遇到问题,先检查这三处

  • 只看到文件列表: 通常说明服务器正常运行,只是当前目录没有首页文件。检查 index.html 是否位于启动目录的顶层。
  • 提示端口被占用: 将命令中的 8000 换成 8001 或其他未使用的端口,并同步修改浏览器地址。
  • 图片或样式无法显示: 检查 HTML 中的资源路径。例如图片放在 images 子目录,就应该引用 images/photo.jpg。路径通常相对于网页文件的位置,而不是终端所在目录。修改后仍看不到变化,可以在浏览器中强制刷新一次。

这些问题通常不是 Python 出错,而是启动目录、端口或网页资源路径没有对应起来。

六、安全提醒:适合临时预览,不适合正式上线

虽然 http.server 非常方便,但它并不是专业的网站服务器。

Python 官方文档明确指出,该模块只实现了基本的安全检查,不建议用于生产环境。另外,如果不指定 --bind 127.0.0.1,服务器默认会监听所有网络接口,同一网络中的其他设备可能访问到共享目录。

因此,建议保留 --bind 127.0.0.1 参数,只在专门的网页练习目录中启动服务。不要直接共享包含私人照片、密码、密钥或工作资料的文件夹。

还需要注意,Python 官方文档提醒,符号链接可能使指定目录以外的文件也被访问到,因此不要随意在不可信环境中开放服务。

总结: 下次需要预览本地网页时,不妨试试 Python 自带的 http.server。进入项目目录,运行一条命令,就能快速获得本机可访问的网页预览环境。无需额外安装工具,用完按 Ctrl+C 关闭即可。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。