使用Jekyll搭建的GitHub Pages博客图片无法显示求助
2026-5-15
解决GitHub Pages博客图片无法加载的问题
我帮你排查几个常见的GitHub Pages图片加载问题，试试这些方法：
检查路径大小写：GitHub是严格区分大小写的！确认你的图片文件名是
Kronothon1.png（大小写完全匹配），同时/assets目录的拼写也没有大小写错误——比如别写成/Assets或者/ASSETS。调整图片引用路径：因为你的文章放在
_posts目录下，引用根目录的assets文件夹时，试试这两种路径写法：- 根路径写法：
（前面的斜杠代表从仓库根目录开始查找） - 相对路径写法：
（../表示跳出当前_posts目录，回到根目录后再进入assets）
- 根路径写法：
确认文件存在性：直接去你的GitHub仓库里检查
assets文件夹，确保Kronothon1.png确实存在，没有被误删或者上传失败。如果文件不存在，重新上传一次即可。触发GitHub Pages重新构建：有时候GitHub Pages会缓存旧资源，导致新上传的图片不显示。你可以随便修改一下博客文章的某个地方（比如加个空格），然后提交并push到仓库，触发重新构建，之后再刷新博客页面看看。
本地预览排查：用Jekyll本地构建你的博客，验证图片是否能正常加载。在项目根目录运行命令：
bundle exec jekyll serve然后访问
http://localhost:4000查看你的文章。如果本地能加载，说明问题出在GitHub Pages的构建或缓存上；如果本地也加载不了，那大概率是路径或者文件本身的问题。
内容的提问来源于stack exchange，提问作者shivank01
相关产品推荐
相关产品推荐
