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

GitHub Pages 404错误及CSS加载失败问题求助

GitHub Pages 404 及 CSS 样式加载失败解决方案

一、Error 404 问题处理

  • 核对仓库配置:项目类型的GitHub Pages仓库,需确保仓库名为cv,且在仓库「Settings -> Pages」中开启Pages服务,部署来源选择正确分支(如main)和目录(如/root)。
  • 查看部署状态:进入仓库Pages设置页,确认部署记录是否显示「Success」,若有失败提示,根据提示修复(如分支不存在、文件结构不符合要求)。
  • 等待部署延迟:GitHub Pages部署通常需要1-5分钟生效,重新创建仓库后不要立即访问,耐心等待后再测试。
  • 清除浏览器缓存:使用无痕模式访问,或清除浏览器缓存(Ctrl+Shift+Del),避免旧缓存导致的404。

二、CSS 样式未加载问题修复

  • 修正CSS引用路径:项目页面的CSS引用需使用相对路径。例如CSS文件在仓库根目录,HTML中应写 <link rel="stylesheet" href="./style.css">,不要使用绝对路径(如/style.css会指向visheshbons.github.io/style.css,而非visheshbons.github.io/cv/style.css)。
  • 确认CSS文件已提交:检查仓库文件列表,确保CSS文件存在且已推送到GitHub,未被.gitignore规则排除。
  • 统一文件名大小写:GitHub区分文件名大小写,若HTML中引用Style.css但实际文件是style.css,会导致加载失败,需保证引用路径与实际文件名完全一致。
  • 利用开发者工具排查:按F12打开浏览器开发者工具,切换到「Console」标签,查看CSS加载的具体错误(如404提示路径错误),根据报错精准修复。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.03 01:35:45