GitHub Pages托管后图片不显示仅显示alt值,VS Code本地运行正常求助
GitHub Pages图片不显示的排查与解决方法
本地VS Code运行时图片能正常显示,但部署到GitHub Pages后只显示alt文本,这是静态站点部署的常见问题,按下面几点排查:
核对路径大小写与格式
GitHub严格区分大小写,而Windows等本地系统不区分。比如你本地写的./images/project1.jpg,如果实际仓库里的文件是./images/Project1.jpg,就会加载失败。另外绝对别用本地的绝对路径(比如C:\xxx\img.jpg),必须用相对于项目根目录的相对路径。确认图片已提交到仓库
登录GitHub检查你的仓库,看看图片文件是不是已经和代码一起push上去了。另外检查.gitignore文件,有没有不小心把图片所在的目录(比如images/)加入了忽略规则,导致图片没被提交。适配GitHub Pages的部署路径
如果是项目站点(URL为https://用户名.github.io/项目名/),图片路径要对应这个前缀。比如图片放在项目根目录的assets/img/下,HTML里可以写./assets/img/xxx.png,或者用/项目名/assets/img/xxx.png的绝对路径(注意开头的斜杠)。强制刷新清除缓存
浏览器缓存可能会导致新上传的图片不显示,按Ctrl+Shift+R强制刷新页面,或者用无痕模式打开站点测试。
内容的提问来源于stack exchange,提问作者NITIN KUMAR
相关产品推荐
相关产品推荐

