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

为何NuGet.org上我的README.md文件图片无法显示?

NuGet包README图片无法加载的解决办法

核心排查点及修复

  • 换用GitHub原始图片链接:别用仓库页面的链接,必须用raw.githubusercontent.com开头的原始资源链接。比如把仓库页面格式的链接改成https://raw.githubusercontent.com/xxx/ImageRepository/main/xxx.png——NuGet只认直接的图片资源地址,仓库页面是网页,没法当作图片加载。
  • 确认图片和仓库公开:确保你的GitHub仓库是公开状态,图片文件没有设置私有权限,直接在浏览器打开raw链接能看到图片才算正常。
  • 规范Markdown图片语法:用标准的Markdown图片格式![图片说明](raw链接),别用HTML的<img>标签,NuGet对HTML标签支持有限。
  • 重新打包发布:改完链接后重新生成nuspec打包,发布后等待一段时间,NuGet.org可能存在缓存延迟,不是刚发布就立马生效。

辅助验证

  • 直接访问图片的raw链接,确认能正常显示,排除图片本身的访问问题。
  • 查看F12调试报错:如果是404错误,说明链接无效;如果是权限类错误,就去检查仓库和图片的访问权限设置。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.21 02:45:50