
用 GitHub Pages 发布 HTML5 网页最省事
只要你的网页是纯静态的(没后端、没数据库),GitHub Pages 就是最直接的一键发布方案——不用买服务器、不配域名、不装 FTP 客户端,连部署命令都只有两行 git push。
- 仓库名必须是
用户名.github.io,否则不会自动启用主页服务 - 确保
index.html在仓库根目录,不是藏在src/或dist/里 - 所有资源路径用相对路径,比如
css/style.css,别写成C:/project/css/style.css - 上传后等 1–2 分钟,访问
https://用户名.github.io即可,无需手动刷新 CDN
Vercel 和 Netlify 更适合带前端框架的 HTML5 项目
如果你用的是 Vue、React 或 Svelte 做的单页应用(SPA),或者用了 vite build 生成了 dist/ 目录,Vercel 和 Netlify 比 GitHub Pages 更省心。
- Vercel 默认识别
dist/或public/为输出目录,留空Build Command即可跳过构建步骤 - SPA 必须加重定向规则:
source: /*, destination: /index.html, type: 200,否则刷新页面会 404 - 它们自动给免费子域名配好 HTTPS,而 GitHub Pages 的自定义域名需手动点一下“Enforce HTTPS”
- 支持环境变量、预览链接(
deploy-preview-xxx.vercel.app),方便协作测试
别用在线“一键发布”工具——它们多数是假的或有陷阱
搜索“HTML5 一键发布工具”,首页常出现一些标榜“拖拽上传、3 秒上线”的网站,但实际要么是伪装成托管平台的广告页,要么要求你注册并上传到他们自己的服务器(后续可能删站、限速、插广告)。
- 真能托管静态页的正规平台只有三类:GitHub Pages、Vercel、Netlify(以及国内的腾讯云 COS + 静态托管)
- 所谓“在线编辑器+发布”工具(如某些 H5 制作平台),导出的其实是 iframe 嵌入链接,不是独立域名的 HTML5 网页
- 微信公众号图文里贴的 H5 链接,背后仍是上述任一托管服务,不是平台自己“发布”的
上传前必查的三个致命细节
90% 的“发布后白屏”“图片不显示”“JS 报错”问题,都出在本地测试和线上环境的差异上,不是工具不行,是你没检查清楚。
立即学习“前端免费学习笔记(深入)”;
-
index.html文件名大小写要一致:Linux 服务器区分大小写,Index.html传上去就打不开 - 所有
href和src路径不能含中文或空格,浏览器可能编码失败,换成about-page.html这种英文短横线命名 - 本地双击打开
index.html是file://协议,但线上是https://,部分 API(如localStorage、fetch)行为不同,务必用Live Server插件或npx http-server本地起 HTTP 服务再测










