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

求助:GitHub README仅部分图片显示,其余消失如何解决?

GitHub README图片消失问题排查指南
  • 核对图片引用路径
    确认README里的图片路径是仓库内的相对路径,比如图片存在assets/imgs/avatar.png,就要写成![头像](assets/imgs/avatar.png)。特别注意GitHub区分文件名大小写,别把Avatar.png写成avatar.png,也别用本地绝对路径或者外部过期链接。

  • 确认图片文件已提交
    去仓库网页端对应目录检查图片是否存在,有没有被误删或者文件名修改。也可以在本地用git log --oneline查看最近的提交有没有涉及图片文件的变动,或者用git status确认图片文件有没有被.gitignore规则拦截没推送到仓库。

  • 检查图片规格
    GitHub对README里的图片有大小限制,单张尽量控制在10MB以内,优先用PNG、JPG这类通用格式,SVG偶尔会有渲染兼容性问题,特殊编码的图片也可能无法正常显示。

  • 强制刷新页面
    浏览器缓存可能会保留旧的失效链接,按Ctrl+Shift+R(Windows)或者Cmd+Shift+R(Mac)强制刷新页面,换个浏览器或者无痕模式打开试试,排除缓存干扰。

  • 确认分支一致性
    检查你查看的README所在分支和图片提交的分支是不是同一个——比如图片提交到了dev分支,但个人主页默认展示的是main分支的README,自然看不到新上传的图片。

  • 排查GitHub服务状态
    偶尔GitHub的静态资源分发服务会出临时故障,这时候去官方状态页确认有没有相关服务异常,等服务恢复后再看图片是否正常显示。

内容的提问来源于stack exchange,提问作者Sabs

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.09 17:12:05