部署Svelte应用至GitHub Pages时npm run build报错的解决办法

错误核心原因 #

构建时的404错误源于prerender阶段无法找到/src/images/github.png资源。Svelte Kit要求静态资源（图片、字体等）必须放在项目根目录的public文件夹下，src目录内的静态资源不会被构建工具正确识别和处理。

具体解决步骤 #

• 调整资源存放路径
  在项目根目录创建public/images文件夹（若不存在），将src/images/github.png移动到public/images/路径下。

• 修正代码中的资源引用
  找到首页（对应/路由的组件）里引用该图片的代码，将路径从/src/images/github.png改为/images/github.png。
  示例修改：

  <!-- 原代码 -->
  <img src="/src/images/github.png" alt="GitHub" />
  
  <!-- 修改后代码 -->
  <img src="/images/github.png" alt="GitHub" />
  

• 重新执行构建命令
  运行npm run build，此时prerender会正确识别图片资源，构建可正常完成。

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