Skip to content
Go back

本地启动静态文件服务器

Edit

预览 HTML、分享构建产物、测 SPA 路由时,本地起一个静态文件服务比直接 file:// 靠谱(避免 CORS、路由 404 等问题)。下面按依赖和场景对比常用方案。

工具对比

工具依赖热重载目录浏览HTTPS配置灵活度亮点适合
npx serveNode可选一条命令、零配置最快预览 dist
npx http-serverNode可选(-S端口、缓存、CORS 参数全需要细调参数
npx live-serverNode保存即刷新前端页面开发
npx static-serverNode极简、零配置快速搭简单服务
npx node-staticNode基础静态服务简单开发场景
python -m http.serverPython 3系统自带、零安装没 Node 的机器
php -SPHPPHP 内置已有 PHP 环境
bunx serveBun可选Bun 生态启动快Bun 项目
Caddy file-serverCaddy自动自动 HTTPS本地也要 HTTPS 时

推荐


Node 系

serve — 最简单:

npx serve .
npx serve ./dist -l 3000

http-server — 参数多:

npx http-server . -p 8080 -c-1                    # -c-1 禁用缓存
npx http-server . -p 443 -S -C cert.pem -K key.pem # HTTPS 需证书和私钥

live-server — 带热重载:

npx live-server --port=8080 --open=/index.html

static-server — 简洁:

npx static-server

node-static — 基于 Node.js(CLI 命令为 static):

npx node-static
# 或:npx --package node-static static

Python

python3 -m http.server 8000
# 指定目录:cd dist && python3 -m http.server 8000

默认绑定 8000,当前目录即根路径,带目录列表。


其他

PHP 内置(单线程,仅开发用):

php -S localhost:8080 -t ./dist

Bun

bunx serve .

Caddy(本地 HTTPS):

caddy file-server --root ./dist --listen :8443

注意


Edit
Share this post on:

Previous Post
用控制台调试各种语言
Next Post
Go defer 打日志