GitHub Pages部署后无法加载图片与JavaScript文件问题求助
修复方案
- 先核对
package.json的homepage字段配置,值必须为"https://jack-baumgartel.github.io/Modern-Abstractions/",末尾斜杠不能缺失,否则会触发资源路径拼接错误。 - 所有静态资源(图片、配置文件)禁止直接使用
/xxx格式的绝对路径,统一用process.env.PUBLIC_URL拼接路径,比如引用public目录下的配置文件写法为${process.env.PUBLIC_URL}/config/config.json,React构建阶段会自动将该变量替换为你设置的homepage路径,保障部署后路径匹配正确。 CONFIG相关功能失效的核心原因是配置文件引用路径不兼容生产环境:确认所有配置文件存放在项目的public目录下,同时按上述PUBLIC_URL规则调整引用路径,不要写死本地相对路径,gh-pages部署时仅会加载build目录下的产物,不在public目录的配置文件不会被打包进生产版本。- 剩余无法加载的图片统一排查路径写法:所有硬编码的
/images/xxx.png类绝对路径全部替换为process.env.PUBLIC_URL + '/images/xxx.png'格式,也可以从当前组件所在目录出发写相对路径访问资源,避免绝对路径默认匹配站点根路径导致的资源缺失。 - 部署前本地验证:每次改完先执行
npm run build,再用静态服务工具启动build目录测试功能和资源加载情况,本地测试通过后再推送到gh-pages,无需反复推送远程验证。
内容的提问来源于stack exchange,提问作者Jack-Baum
相关产品推荐
相关产品推荐

