必须通过HTTP/HTTPS协议访问才能正常运行，因file://协议会禁用跨源请求并限制API权限；需确保路径为相对路径、入口文件名正确、API地址适配线上环境；推荐GitHub Pages零配置部署。
本地 HTML5 文件直接丢到服务器就行？别急，先看这三件事
不是所有 HTML5 网页扔进 FTP 就能跑。常见问题：图片不显示、fetch() 报 CORS error、localStorage 读写失败、Canvas 动画卡顿——这些几乎都源于「没走 HTTP 协议」。本地双击打开 index.html 是用 file:// 协议，现代浏览器会禁用跨源请求、限制部分 API 权限。真正发布，必须让文件通过 http:// 或 https:// 访问。
批量发布多文件 HTML5 网页的实操路径
核心思路：把整个项目目录（含 index.html、js/、assets/、data.json 等）当做一个静态站点部署，而非单个文件上传。
- 确认入口文件名是
index.html（或服务器支持的默认首页，如default.html；否则需手动指定 URL 路径） - 检查所有资源路径是否为相对路径：
./images/logo.png✅，file:///C:/xxx/logo.png❌，C:\assets\sound.mp3❌ - 避免硬编码本地路径或开发时用的端口（如
http://localhost:8080/api），API 地址应改为相对路径/api/data或完整线上地址https://api.yoursite.com/data - 如果用了
service worker，确保scope和注册路径匹配，且sw.js在根目录或显式声明路径
零配置快速上线：GitHub Pages + 多子页面结构
适合教学演示、作品集、小型交互应用。不用买服务器，不配域名也能用 username.github.io/repo-name 访问。
- 每个 HTML5 子项目单独建一个仓库（如
game-pong、chart-demo），或统一放在主仓库的子目录（如/demos/physics-sim/） - 启用 GitHub Pages：Settings → Pages → Source 选
mainbranch +/ (root)（若放子目录则选/docs或自定义路径） - 注意：GitHub Pages 默认不执行
file://类行为，但也不支持 PHP/Node 后端；所有逻辑必须前端完成 - 子页面跳转示例：
物理模拟，路径以/开头才不会变成/demos/demos/physics-sim/
本地测试阶段就该验证的发布敏感点
很多“上线后才崩”的问题，其实 live-server 或 python3 -m http.server 就能提前暴露。
