You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.12 21:51:03