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 协议本地预览，才能模拟真实发布环境。
立即学习“前端免费学习笔记（深入）”；
- 最简单方式：VS Code 安装插件
Live Server，右键index.html→ “Open with Live Server”，它会起一个http://127.0.0.1:5500服务 - 没装编辑器？Python 自带 HTTP 服务：
python3 -m http.server 8000（终端进入项目根目录后执行） - 此时浏览器地址栏必须是
http://开头，而不是file://；F12 控制台看 Network 标签页，所有资源状态码应为 200
发布后打不开？先查这四个地方
90% 的“发布失败”问题都出在这几个具体位置，别急着重传或换平台。
-
index.html文件名大小写错误：Linux 服务器区分大小写，INDEX.HTML或Index.html在 GitHub Pages 上不会被识别为首页 - CSS/JS 路径写成绝对路径：比如写了
src="C:/myproject/script.js"—— 这种路径只在你电脑上存在，服务器根本没有这个盘符 - 图片用了中文名或空格：像
产品介绍.jpg上传后可能变成%E4%BA%A7%E5%93%81%E4%BB%8B%E7%BB%8D.jpg，但 HTML 里仍写原名，导致 404 - 用了本地开发时的 console.log 或 debugger；虽不影响功能，但暴露路径结构或调试逻辑，建议上线前清理
真正麻烦的不是上传动作本身，而是路径引用是否全量适配了 HTTP 环境。本地能跑 ≠ 发布能跑，关键差异就在协议、路径解析规则和安全策略这三层。
