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

Jekyll文章添加图片后部署出现404错误,求解决方案

Jekyll部署后图片无法加载(404)的解决方案
  • 修正图片路径适配部署环境
    若你的站点配置了baseurl,本地直接使用根路径/images/xxx.jpg能正常访问,但部署后会因缺少站点前缀导致404。将图片路径修改为带baseurl的动态路径:

    ![Image]({{ site.baseurl }}/images/IMG_20231109_171049.jpg)
    

    这样Jekyll构建时会自动拼接站点的baseurl,保证部署后路径正确。

  • 核对文件名大小写
    本地Windows系统不区分文件名大小写,但部署服务器多为Linux系统,大小写敏感。确认远程仓库中图片文件名IMG_20231109_171049.jpg的大小写和本地完全一致,避免因大小写差异导致找不到文件。

  • 确认图片文件夹已被部署
    检查.gitignore文件是否排除了images文件夹,确保该文件夹及内部图片已被提交到远程代码仓库。可以登录部署平台查看文件结构,确认images文件夹存在且包含目标图片。

  • 配置Jekyll构建包含规则
    打开_config.yml,确认是否添加了images文件夹的包含配置,确保Jekyll构建时会将该文件夹打包到输出目录:

    include:
      - images
    

    配置完成后重新执行bundle exec jekyll build,再部署更新后的构建产物。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.30 08:24:55