SvelteKit构建产物在GitHub Pages无法加载外部文件求助

问题现象 #

• 部署在GitHub独立分支的站点无法找到构建目录文件，访问时_app文件夹下的所有资源都无法被定位，页面所有GET请求均返回失败
• 本地开发环境中，TailwindCSS样式能正常加载，但JS代码完全无法运行

问题根源 #

经过排查，确认问题出在文件名（含文件夹名）中的下划线——SvelteKit对带有下划线的文件/目录存在处理逻辑异常，会导致资源路径无法被正确解析，进而引发加载失败。

解决方案 #

• 全面检查项目内的所有文件和文件夹名称，将包含下划线的名称替换为短横线（-）或驼峰命名格式
• 重新执行构建命令，将新的构建产物部署到GitHub分支，确保资源路径能被正确识别

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