发布首个Flutter包：README中GIF在pub.dev不显示的问题

核心原因：GitHub的防盗链机制 #

GitHub对其raw资源（包括仓库里存储的GIF）设置了Referer防盗链校验，只有来自GitHub自身域名的请求才能正常加载这些资源。pub.dev的域名不在GitHub允许的请求来源列表里，因此当pub.dev解析README中的GitHub GIF链接时，会被拦截，导致无法显示。

如果你的README里用的是GitHub仓库的相对路径或者blob路径（非raw资源直链），pub.dev会自动解析为raw.githubusercontent.com的地址，同样会触发防盗链限制。

解决方法 #

• 更换外链存储：把GIF上传到支持无限制外链的图床服务，将README里的GIF链接替换为图床提供的直接资源URL。
• 转换格式优化：可以把GIF转换成WebM格式（体积更小、加载更快），再上传到图床替换链接，兼容性能覆盖大部分场景。
• 内嵌演示资源：如果不想依赖第三方服务，也可以把GIF作为包的示例资源包含在仓库中，在pub.dev的包详情页通过单独模块展示，但这种方式不如直接替换外链高效。

内容的提问来源于stack exchange，提问作者Eray Hamurlu