HTML5游戏双击index.html无法运行是因浏览器CORS策略限制file://协议下的资源加载；解决方法是用http-server等本地HTTP服务（如npx http-server -p 8080）启动，访问http://localhost:8080。
HTML5 游戏不需要“安装”，它本质上是一组网页文件（index.html、game.js、assets/ 等），浏览器直接加载就能运行——但前提是路径正确、资源可访问、环境满足要求。
为什么双击 index.html 打不开或报错 CORS
本地双击打开 HTML 文件时，浏览器会以 file:// 协议加载，此时多数现代浏览器（Chrome、Edge、Firefox）会阻止 JavaScript 读取本地文件（如 JSON 配置、图片、音频），报错类似：
Access to XMLHttpRequest at 'file:///path/to/data.json' from origin 'null' has been blocked by CORS policy.
这不是游戏写错了，是浏览器安全策略限制。解决方法只有两个：
- 用本地 HTTP 服务启动，例如：
npx http-server（需 Node.js）、python3 -m http.server 8000（Python 内置） - 改用支持
file://加载的浏览器（如旧版 Firefox 可通过about:config→security.fileuri.strict_origin_policy = false关闭限制，但不推荐）
怎么用 http-server 快速跑起 HTML5 游戏
http-server 是最轻量、零配置的静态服务器，适合快速验证游戏是否能正常加载资源：
立即学习“前端免费学习笔记（深入）”；
- 确保目录结构合理：根目录下有
index.html，所有 JS/CSS/图片/音频都在同目录或子目录中（如js/main.js、assets/sprite.png） - 终端进入游戏文件夹，执行：
npx http-server -p 8080 - 浏览器访问
http://localhost:8080，不是file://路径 - 若游戏依赖 WebSocket 或音视频流，需确认服务器是否支持（
http-server不支持 WebSocket，此时需换用ws或express）
常见资源加载失败原因和检查点
即使走 http://localhost，游戏仍可能白屏或卡在加载界面。重点查以下几项：
-
console.log是否报 404？比如请求了/sounds/jump.mp3，但实际路径是assets/sounds/jump.mp3—— 检查fetch()或new Audio()的路径字符串 - 音频是否被静音策略拦截？Chrome 要求用户交互（如点击）后才能播放音频，直接
audio.play()会 Promise reject，需加.catch(e => console.warn("Audio play failed:", e)) - Canvas 渲染是否因
requestAnimationFrame被节流？隐身模式、后台标签页下帧率可能极低，用performance.now()检查 delta 时间是否异常大 - 游戏用了
localStorage或IndexedDB？私密窗口或某些浏览器扩展可能禁用持久化存储
真正麻烦的从来不是“怎么运行”，而是路径写错、协议限制、音频策略、跨域字体（@font-face 加载 .woff2 也受 CORS 影响）这些细节——它们不会报语法错误，但会让游戏停在黑屏或加载条不动。
