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

如何在将HTML网站部署到GitHub公开后保留背景图片?

解决GitHub Pages部署后背景图片消失的问题
  • 核对文件路径与实际结构
    先确认你的项目文件夹结构是否和CSS里的路径匹配。比如你说单独创建了图片文件夹,但CSS里写的是../css/resume-background.jpg,这说明你把图片放在了css文件夹里?如果图片是在独立的images文件夹,那路径肯定错了。举个正确的结构例子:

    项目根目录
    ├── index.html
    ├── css/
    │   └── style.css
    └── images/
        └── resume-background.jpg
    

    这种情况下,CSS里的路径应该改成url(../images/resume-background.jpg)。

  • 注意文件名大小写
    GitHub Pages是严格区分大小写的!本地系统可能不区分,但部署后如果文件名是Resume-Background.jpg,而CSS里写的是resume-background.jpg,就会找不到图片。必须保证引用的文件名和实际文件名完全一致。

  • 改用根相对路径
    相对路径容易受页面层级影响,试试用根相对路径,也就是从项目根目录开始的路径,比如url(/images/resume-background.jpg)(前提是图片在根目录下的images文件夹里)。这种方式在部署后更稳定,不会因为页面跳转导致路径失效。

  • 确认图片已上传到GitHub仓库
    检查GitHub仓库里是否存在这张背景图,有时候本地的图片没被加入Git提交,部署时自然找不到。确保执行过git add、git commit、git push把图片同步到仓库里。

  • 检查CSS文件的引用是否正确
    先确认HTML里的CSS引用路径没问题,比如根目录的HTML引用CSS应该是<link rel="stylesheet" href="css/style.css">,如果CSS本身就没加载成功,背景图肯定显示不出来。

内容的提问来源于stack exchange,提问作者Insanity10

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.29 19:22:03