HTML5网页发布前必须确认三件事:一是用HTTP服务本地预览(非file://协议),二是所有资源路径改为相对或根相对路径并确保文件名大小写正确,三是部署到支持HTTPS的托管平台如GitHub Pages。
HTML5网页发布前必须确认的三件事
不是写完 index.html 就能直接“上线”的。新手常卡在“本地能打开,别人打不开”这一步——本质是混淆了「本地浏览」和「公开访问」。发布 = 让别人的电脑通过互联网请求到你的文件,所以必须有:一个带公网IP的服务器(或托管服务)、一个HTTP响应、一个可被解析的域名或IP地址。
- 删掉所有
file://开头的路径引用(比如图片、CSS),全部改用相对路径(./style.css)或根相对路径(/assets/logo.png) - 确保没有调用本地 API(如
navigator.geolocation在非 HTTPS 页面会失效;localStorage没问题,但serviceWorker必须 HTTPS) - 检查控制台有没有 404 报错——本地双击打开时,浏览器不校验跨域,但 HTTP 服务会严格按路径找文件
用 GitHub Pages 零成本快速发布(推荐新手首选)
不需要买服务器、不用装环境、不碰命令行也能发。GitHub Pages 会自动把仓库里的 HTML 渲染成可公开访问的网页,且支持自定义域名和 HTTPS(强制启用)。
- 新建一个 GitHub 仓库,名称格式为
用户名.github.io(例如alice.github.io) - 把你的
index.html和配套资源(css/、js/、images/)全部提交到主分支(main或master) - 进仓库 Settings → Pages → Source 选
Deploy from a branch→ Branch 选main→ Save - 几秒后页面会显示类似
https://alice.github.io的链接,点开就是你的网页
注意:index.html 必须在仓库根目录;子目录(如 /blog/index.html)不会被自动识别为首页;如果用了 fetch() 加载本地 JSON,确保该 JSON 文件也提交到了仓库里,路径要和代码中一致。
本地测试 HTTP 服务比双击更靠谱
双击 index.html 是用 file:// 协议打开,很多现代 Web API(如 fetch、WebGL 初始化、某些字体加载)会被浏览器直接禁用。必须用 HTTP 协议本地预览,才能模拟真实发布环境。