Github Pages图片不显示：文件夹名称无法更新为小写求助

问题情况 #

首次推送项目时，index.html中的图片能正常在Github Pages展示；了解到Github Pages区分大小写后，把所有内容改成小写，推送后发现Github Pages里的图片文件夹名称未更新，导致部署后图片全部无法显示，但本地localhost运行完全正常，修改路径名称、统一改为小写后仍未解决。

核心原因 #

Git默认不会追踪文件名的大小写变更（因为Windows等系统的文件系统不区分大小写），你本地修改文件夹大小写后，Git识别不出这是变更，所以不会同步到远程Github仓库，导致Github Pages上还是原来的文件夹名称，和代码里的小写路径不匹配——而Github Pages运行在Linux环境，严格区分大小写，因此图片加载失败。

解决步骤 #

• 强制开启Git对文件名大小写的追踪：在本地项目根目录终端执行

  git config core.ignorecase false
  

• 分两步重命名文件夹（避免Git识别不到变更）：
  1. 先把图片文件夹改成临时名称，提交推送

     git mv 原文件夹名 temp-folder
     git commit -m "临时重命名图片文件夹"
     git push
     

  2. 再把临时文件夹改成目标小写名称，提交推送

     git mv temp-folder 目标小写文件夹名
     git commit -m "将图片文件夹改为小写"
     git push
     

• 检查代码中的所有图片路径，确保和远程仓库的文件夹、文件名大小写完全一致，比如<img src="./images/avatar.png">
• 若仍未生效，前往Github仓库的「Settings」→「Pages」，切换一下部署分支（比如先选别的分支再切回原分支），触发重新部署以清除缓存

注意事项 #

本地Windows/macOS系统的文件系统不区分大小写，所以修改路径后本地能正常加载，但Github Pages运行在Linux环境，严格区分大小写，必须保证代码路径和远程仓库的文件名完全匹配。

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