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

GitHub图片上传失败求助:README及仓库图片无法正常显示

GitHub README/仓库图片上传防裂图解决方案
  • 直接在仓库内存储图片并使用相对路径
    先在仓库里新建一个专门存图片的文件夹(比如assets/images),把图片上传到这个文件夹里,确认文件上传成功后,在README里用相对路径引用,格式是:![图片描述](./assets/images/你的图片文件名.png)。如果图片直接在仓库根目录,就写![图片描述](./你的图片文件名.png)。这种方式最靠谱,图片和仓库绑定,不会因为外部链接失效裂图。

  • 检查图片链接的有效性
    如果用外部链接(不推荐),一定要复制图片的直接访问URL,不是网页链接。比如在Issue里上传图片后,右键点击图片选择“复制图片地址”,而不是复制Issue的页面链接。同时要检查路径的大小写、后缀名是否正确——GitHub的文件路径是区分大小写的,后缀写错也会导致裂图。

  • 确认仓库权限与图片状态
    如果是私有仓库,要确保查看README的用户有仓库的访问权限,否则图片会加载失败。上传图片后,先刷新仓库页面确认图片文件确实存在,再去README里引用。

  • 正确使用GitHub拖拽上传功能
    打开README的编辑页面,激活编辑框后,直接把本地截图拖拽到编辑框内,GitHub会自动把图片上传到仓库的assets文件夹(自动创建),同时生成正确的相对路径代码,直接保存编辑内容即可。别把图片拖到页面其他区域,要确保拖到编辑框里。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.27 12:02:36