Godot Web 导出：浏览器存储、加载页和平台限制的客户端策略

Web 版本不是把桌面包导成 HTML

Godot 支持 Web 导出，这让试玩、活动页、教育项目和轻量游戏分发变得方便。玩家点开链接就能玩，不用安装。但 Web 平台限制很多：包体下载、浏览器缓存、IndexedDB、音频自动播放、线程支持、内存上限、移动浏览器兼容、页面刷新导致状态丢失。把桌面版本直接导成 Web，往往会遇到加载慢、存档不稳、声音不播、某些浏览器黑屏。

Web 客户端要把浏览器当成一个特殊平台，而不是桌面平台的缩水版。它需要专门的加载体验、资源策略、存档策略和失败提示。

flowchart TD
    A[玩家打开网页] --> B[HTML Shell 加载]
    B --> C[下载 wasm/pck]
    C --> D{浏览器能力检查}
    D -->|通过| E[启动 Godot]
    D -->|失败| F[显示兼容提示]
    E --> G[挂载持久化存储]
    G --> H[读取存档/配置]
    H --> I[进入游戏首屏]

加载页要先于 Godot 运行

Web 版最大痛点是首次加载。wasm、pck、资源包都要下载。Godot 引擎启动前，游戏内 UI 还不可用，所以需要 HTML shell 提供清楚加载页：下载进度、包体大小、失败重试、浏览器提示。不要让玩家盯着空白页。

加载页文案要真实。网络慢时显示正在下载哪个阶段，失败时提示刷新或换浏览器。对大型包体，可以说明首次加载较久，后续会使用缓存。玩家对网页空白的容忍度比安装包低很多。

如果游戏有可选资源，Web 版更应该分阶段。先下载最小可玩包，进入后再按需下载关卡或皮肤。把所有资源塞进初始 pck，会让转化率很差。

浏览器存储不是普通文件系统

Godot Web 的 user:// 通常映射到浏览器持久化存储，背后可能是 IndexedDB。写入和同步行为与桌面文件系统不同。页面刷新、浏览器隐私模式、存储配额、用户清理站点数据都会影响存档。

存档系统要知道自己在 Web 平台。保存后尽量确认 flush，同步到持久化层。重要存档可以提示已保存，或者提供云端账号同步。不要把 Web 本地存档当成绝对可靠。

存储空间不足时，要给出可理解提示。浏览器不会像桌面一样让玩家看到文件路径。诊断信息应包括浏览器、是否隐私模式、存储估算和最近保存错误。

音频和输入受浏览器策略限制

浏览器通常禁止页面未交互前自动播放音频。Godot 游戏启动后，背景音乐可能不会立即播放，直到玩家点击页面。客户端要处理这种状态：显示“点击开始”按钮，点击后解锁音频，再进入主菜单。

键盘输入也受页面焦点影响。玩家点击浏览器外，游戏失焦；某些快捷键被浏览器拦截；移动端虚拟键盘和触控行为也不同。输入系统要监听焦点变化，恢复时清理按键状态。

鼠标捕获和全屏也需要玩家手势触发。第一人称或动作游戏要在合适时机请求，而不是启动时强行请求失败。

线程、SharedArrayBuffer 和兼容性

Godot Web 的线程能力取决于浏览器和服务器跨源隔离配置。某些功能需要特定 HTTP headers。客户端发布到 Web 时，不只看 Godot 导出，还要看部署服务器。没有正确 header，线程版本可能无法运行。

如果目标是广泛兼容，可以选择非线程导出，但性能可能受限。项目要测试目标浏览器矩阵：Chrome、Firefox、Safari、Edge、移动端浏览器。Safari 和 iOS WebView 经常有特殊限制。

兼容性检查应在 HTML shell 做。发现浏览器不支持必要能力时，给出明确提示，而不是 Godot 启动失败后黑屏。

Web 版日志和反馈

玩家在浏览器里遇到问题，日志更难拿。可以在页面提供复制诊断信息按钮：浏览器 UA、游戏版本、加载阶段、存储状态、最近错误。控制台日志对普通玩家不友好。

错误上报要轻量。Web 版启动失败时，Godot 还没运行，HTML shell 也要能上报加载错误。否则最关键的失败阶段没有数据。

小结

Godot Web 导出需要专门的客户端策略。HTML 加载页负责启动前体验，资源分阶段降低首次等待，浏览器存储和音频策略要单独处理，线程和兼容性依赖部署环境，诊断工具覆盖 Godot 启动前后。Web 版本不是桌面包的副产品，而是一个独立发布目标。
我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。

我会把 Web 发布检查分成两层：Godot 导出包检查和服务器 header 检查。很多 Web 问题不是游戏代码，而是部署缺少跨源隔离或缓存策略，发布流程必须一起验证。