GitHub Pages图片无法加载求助：本地正常线上失效

以下是几个最常见的原因和对应解决方法：

• 路径大小写不匹配
  本地Windows/macOS环境对文件路径大小写不敏感，但GitHub Pages运行在Linux环境，大小写严格区分。比如本地写Images/avatar.png，但仓库里实际是images/avatar.png，就会加载失败。检查所有图片路径的大小写，和仓库里的文件结构完全一致。

• 错误的路径类型
  本地开发时如果用了绝对路径（比如C:/Projects/site/img/bg.jpg），线上肯定无法识别。必须改用相对路径：

  • 图片和HTML文件同目录：直接写bg.jpg
  • 图片在子目录：比如assets/img/bg.jpg或者./assets/img/bg.jpg
  • 避免用根路径开头的/assets/img/bg.jpg，除非你的仓库是用户站点（比如username.github.io），否则项目站点的根路径会包含仓库名，路径会出错。

• 文件名含特殊字符或空格
  文件名里的空格、中文或者特殊字符（比如#、&）可能导致加载失败。把文件名改成纯英文、数字，用连字符-或者下划线_分隔，比如把我的图片.jpg改成my-image.jpg。

• 部署延迟或设置问题

  • 刚push代码后，GitHub Pages可能需要几分钟才能完成部署，别急着刷新，等5-10分钟再试。
  • 检查仓库的Pages设置：进入仓库的「Settings」→「Pages」，确认部署分支（比如main）和部署目录（比如/(root)）选择正确，且页面显示「Your site is live at...」。

• 文件未正确上传
  检查仓库里是否真的存在对应的图片文件，有时候push时可能漏传了文件，或者.gitignore里不小心排除了图片目录。查看仓库的文件列表，确认图片文件存在。

内容的提问来源于stack exchange，提问作者Youcef Boudour