GitHub Pages仅PNG图片可正常显示,JPG/GIF图片异常如何调试?
GitHub Pages 非PNG格式图片加载异常排查方案
- 检查响应头MIME类型
打开浏览器开发者工具的「网络」面板,刷新加载异常的图片资源,查看对应请求的响应头中Content-Type字段。jpg格式正常应返回image/jpeg、gif格式正常应返回image/gif,如果返回其他类型(如text/plain)则是GitHub Pages识别文件类型出错。 - 校验Git的文件类型配置
检查项目根目录是否存在.gitattributes文件,确认是否有错误规则将jpg、gif标记为文本类型:Git会自动转换文本文件的换行符,会直接损坏二进制格式的图片文件。如果存在错误配置,补充以下规则后重新提交推送:*.jpg binary *.jpeg binary *.gif binary - 校验文件完整性
将gh-pages分支中异常的jpg、gif文件下载到本地,和原始文件做哈希值对比(可使用md5sum命令校验),如果哈希值不一致说明文件在提交、推送过程中被篡改。 - 检查自动构建流程逻辑
如果你使用了GitHub Actions等CI工具自动构建部署站点,检查构建脚本中是否包含图片压缩、转码的逻辑,是否存在配置错误导致jpg、gif文件处理后损坏,可临时关闭图片处理逻辑验证问题。 - 关闭GitHub Pages自带优化功能
进入仓库「Settings - Pages」设置页,关闭Pages自带的资源压缩、优化选项,重新触发部署后验证图片加载是否恢复正常。
内容的提问来源于stack exchange,提问作者alwxkxk
相关产品推荐
相关产品推荐

