为何NuGet.org上我的README.md文件图片无法显示?
NuGet包README图片无法加载的解决办法
核心排查点及修复
- 换用GitHub原始图片链接:别用仓库页面的链接,必须用
raw.githubusercontent.com开头的原始资源链接。比如把仓库页面格式的链接改成https://raw.githubusercontent.com/xxx/ImageRepository/main/xxx.png——NuGet只认直接的图片资源地址,仓库页面是网页,没法当作图片加载。 - 确认图片和仓库公开:确保你的GitHub仓库是公开状态,图片文件没有设置私有权限,直接在浏览器打开raw链接能看到图片才算正常。
- 规范Markdown图片语法:用标准的Markdown图片格式
,别用HTML的<img>标签,NuGet对HTML标签支持有限。 - 重新打包发布:改完链接后重新生成nuspec打包,发布后等待一段时间,NuGet.org可能存在缓存延迟,不是刚发布就立马生效。
辅助验证
- 直接访问图片的raw链接,确认能正常显示,排除图片本身的访问问题。
- 查看F12调试报错:如果是404错误,说明链接无效;如果是权限类错误,就去检查仓库和图片的访问权限设置。
内容的提问来源于stack exchange,提问作者S Mxller
相关产品推荐
相关产品推荐

