VSCode中PartyTown正常运行，GitHub Pages报404错误求助

问题根源 #

1. GitHub Pages不识别~这类路径别名，而本地live-server可能通过配置解析了该别名，导致~partytown/partytown.js无法找到
2. 本地开发使用的相对路径（如../javascript/app.js），在GitHub Pages的部署目录结构下可能指向错误位置，因为本地层级和部署后层级不一致

具体解决步骤 #

• 修正PartyTown核心脚本路径
  把~partytown/partytown.js替换为实际部署路径：

  • 如果是根域名站点，直接改为：

    <script src="/partytown/partytown.js"></script>
    

  • 如果是项目站点（如仓库名为my-project），需加上仓库名前缀：

    <script src="/my-project/partytown/partytown.js"></script>
    

• 调整本地脚本的相对路径
  将../javascript/app.js这类相对路径改为基于站点根目录的绝对路径：

  • 根域名站点示例：

    <script defer type="text/partytown" src="/javascript/app.js"></script>
    

  • 项目站点示例：

    <script defer type="text/partytown" src="/my-project/javascript/app.js"></script>
    

• 确认PartyTown静态文件完整部署
  确保partytown目录下的所有必要文件（partytown.js、partytown-sw.js、vitals.js等）已提交到GitHub仓库，且部署后能通过浏览器直接访问到这些文件（可在地址栏输入对应URL测试）。

• 自定义PartyTown资源路径（可选）
  若需指定资源路径，可通过配置脚本声明：

  <script>
    window.partytown = {
      lib: '/partytown/' // 项目站点改为 '/my-project/partytown/'
    };
  </script>
  <script src="/partytown/partytown.js"></script>
  

修改完成后提交代码到GitHub，等待部署完成后测试页面，即可解决404错误。

内容的提问来源于stack exchange，提问作者Pandofla