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

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.20 16:12:06