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

Github Pages部署异常:CSS与JS资源无法正常加载求助

解决Github Pages部署后CSS/JS资源加载失败的问题

常见原因及修复步骤

  • 检查资源路径是否正确
    你的部署地址属于子路径(/agecalculator/),如果HTML里引用资源时用了根路径开头(比如/css/style.css),会被解析为根域名下的路径,而实际资源在子路径目录下。
    修复方法:

    1. 改用相对路径,比如把/css/style.css改成./css/style.css或css/style.css(根据HTML文件所在位置调整层级)
    2. 或者在HTML的<head>标签内添加基础URL配置:
      <base href="https://vipin10100001.github.io/agecalculator/">
      
      这样所有根路径开头的资源引用都会自动带上该前缀。
  • 确认资源文件名大小写
    Github对文件名大小写敏感,若HTML里的资源引用(比如/CSS/style.css)和仓库中实际文件名(比如/css/style.css)大小写不一致,会导致加载失败,需保证两者完全匹配。

  • 核对Github Pages部署设置
    进入仓库的Settings -> Pages页面,确认部署分支和目标目录选择正确(比如是否误将资源所在的docs目录选为部署目录,而实际资源在主分支根目录)。

  • 强制刷新浏览器缓存
    部分情况下浏览器会缓存旧的错误路径资源,按下Ctrl+Shift+R(Windows)或Cmd+Shift+R(Mac)强制刷新页面,验证资源是否能正常加载。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.22 03:07:05