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

上传代码至GitHub Pages后网页CSS/JS丢失的技术求助

GitHub Pages 加载CSS/JS资源失败的排查方案
  • 核对文件名大小写:GitHub Pages基于Linux环境,文件名严格区分大小写,而本地Windows/macOS通常不区分。比如本地写的Style.css,仓库里实际是style.css,就会导致引用失败,务必保证HTML里的资源名和仓库里的完全一致。
  • 配置base标签(项目站点专属):如果你的Pages地址是https://xxx.github.io/your-project/这类项目子站点,必须在HTML的<head>里添加<base href="/your-project/">,否则相对路径会从根域名出发,找不到项目下的资源。
  • 查看构建日志找报错:进入仓库的Settings -> Pages,找到构建日志入口,里面会明确列出资源加载的404或其他错误,直接定位问题点。
  • 强制清除浏览器缓存:有时候浏览器缓存了旧页面,按Ctrl+Shift+R(Windows)或Cmd+Shift+R(Mac)强制刷新,排除缓存干扰。
  • 检查.gitignore规则:别忽略了这个——确认CSS/JS文件或目录没被加到.gitignore里,导致资源根本没上传到仓库,哪怕你觉得代码传成功了,也去仓库文件列表里核对一遍。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.11 07:42:04