俺是个较小白， 刚启动用github pages搭网站的时候，遇到个较大问题， 太硬核了。 就是图片怎么都体现不出来后来查了良好更多资料才搞明白，这里分享一下俺的经验。

为啥图片体现不出来？

github pages是个静态网站托管服务， 它只能托管你提交到仓库里的文件， 调整一下。 如果你的html里引用了本地图片，但是图片没提交到仓库，那确定是看不到的。

还有就是 github pages不支持后端服务，也就是说你 我心态崩了。 不能写个程序动态生成图片或者提供给私有文件下载，这都是不行的。

正确的做法

先来看， 你得把你的项目结构整理良好，比如这样：

my-website/
├── assets/
│   ├── images/
│   │   └── hero.jpg  ← 你的图片
│   └── docs/
│       └── report.pdf  ← 你链接的文档

太刺激了。 然后在你的html里采用相对路径引用这一些资源条件，比如：

提交文件到GitHub

光是在本地弄良好还不行，你得把这一些文件都提交到github仓库里采用git add .然后git commit -m "add images and docs"最后再来看git push，实锤。。

只有出当前仓库中的文件，GitHub Pages构建后才会托管并可被公网访问。

测试部署最终还是结果是

部署完成后 你能够直接访问资源条件的URL来测试，比如： ? https://your-username.github.io/my-website/assets/images/hero.jpg 如果返回图片，那就说明路径正确；如果体现404，那就检查一下你的路径是不是写错了。

所见即所存，所链即所传。这就是github pages的核心原则， 把文件放进仓库、路径写对、推送到远程——访客就能看到；反之，必报错。清晰明白这一机制，是构建可靠静态网站的第一步，也许吧...。

俺的经验就分享到这里 希望能帮到你，如果你还有其他问题，能够在下面留言！

纯正。 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed sit amet nulla auctor, vestibulum magna sed, convallis ex.

希望当前这个修改后的版本！