上传代码至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
相关产品推荐
相关产品推荐

