本地双击HTML文件用file://协议会因浏览器安全限制导致fetch、localStorage等API失效，必须通过HTTP协议（如http://localhost:8000）运行；静态网页应托管于GitHub Pages、Vercel等静态托管平台，注意路径大小写、相对引用及HTTPS要求。
本地写好的 HTML5 网页，不需要任何“发布系统”或“后台服务”，只要把文件放到能被浏览器访问的路径里，它就能运行——但直接双击 index.html 和真正“发布”有本质区别：前者走的是 file:// 协议，后者必须走 http:// 或 https://。这是绝大多数新手卡住的第一步。
为什么双击打开的 HTML5 网页在本地能跑，一上传就报错？
因为现代浏览器对 file:// 协议做了严格限制：fetch()、XMLHttpRequest、localStorage 在某些安全上下文中会被禁用，跨域图片/字体/font-face 加载失败，Service Worker 根本不注册——这些都不是你代码写错了，是协议层面不支持。
解决办法只有一个：让浏览器通过 HTTP 协议加载页面。
- 本地测试时，别双击，改用命令行起一个最小 HTTP 服务：
npx serve（需先装 Node.js）或python3 -m http.server 8000 - 确认地址是
http://localhost:8000/index.html，不是file:///xxx/index.html - 所有相对路径（如
./css/style.css）要以当前 HTML 文件所在目录为基准，避免用../越级引用导致上线后 404
静态网页怎么扔到网上？选对托管方式比写代码还重要
HTML5 是纯前端技术，没有 PHP、数据库、登录态，所以完全适配静态网站托管（Static Hosting）。别买虚拟主机、别折腾 FTP 客户端，除非你明确需要 .htaccess 或服务器端 includes。
立即学习“前端免费学习笔记（深入）”；
- 免费又可靠：GitHub Pages（绑定
username.github.io）、Vercel（支持自定义域名 + 自动 CI）、Netlify（拖拽上传 + 表单后端集成） - 国内可选：Gitee Pages（速度尚可，但不支持 HTTPS 自定义域名）、腾讯云 COS 静态网站托管（需配置跨域和默认首页，但稳定）
- 避开陷阱：不要用百度云盘、微云、QQ邮箱附件这类“伪链接”分享，它们返回的是下载页或跳转页，不是真实 HTTP 响应头
上传前必须检查的三件事
很多“发布失败”其实只是路径或 MIME 类型没配对，而不是代码问题。
- 确认
<link rel="stylesheet" href="css/style.css">中的css/style.css确实存在于你上传的文件夹结构里，且大小写完全一致（Linux 服务器区分大小写） - 检查图片路径是否用了绝对路径如
/img/logo.png——如果部署在子路径（如https://example.com/my-project/），这个/img/就会指向根目录，应改为相对路径img/logo.png或用<base href="./"> - 确保服务器返回正确 Content-Type：
.html→text/html，.js→application/javascript，否则 Safari 会直接拒绝执行 JS
最常被忽略的一点：HTML5 的离线能力（manifest、Cache API、Service Worker）依赖 HTTPS，本地 localhost 可豁免，但一旦部署到真实域名，必须启用 HTTPS，否则相关 API 会静默失效——连控制台都不报错。
