GitHub Pages部署站点后CSS样式无法加载显示问题求助

核心原因 #

GitHub Pages的项目级站点（非<用户名>.github.io根仓库的站点）的服务根路径为https://<用户名>.github.io/<仓库名>/，不是域名根目录，路径配置错误会导致CSS资源404无法加载。 #

解决步骤 #

1. 先确认仓库文件结构：仓库根目录下存在css文件夹，且文件夹内有style.css文件，排除文件未推送、路径层级和本地不一致的问题。
2. 选择以下任意一种正确的CSS引用写法：

• 相对路径写法（兼容性最高，本地预览和线上部署通用）：
  直接写href="css/style.css"，无需加多余的斜杠、点斜杠前缀，会基于当前HTML文件所在路径自动查找资源，只要你的HTML文件放在仓库根目录即可正常生效。
• 绝对路径写法：
  写href="/Mini-School/css/style.css"，开头斜杠代表站点根路径，必须带上你的仓库名Mini-School才能正确定位到资源。

3. 部署验证
   修改完成推送代码后，等待3-5分钟让GitHub Pages完成部署（Pages部署非实时，刚推送完立刻刷新可能还是旧版本）。如果仍未生效，按F12打开浏览器开发者工具，切换到「网络」标签刷新页面，查看CSS资源的请求状态：

• 若状态码为404：点击请求查看完整URL，对比实际CSS文件的地址调整路径即可
• 若状态码为200但样式未生效：检查CSS文件内容是否存在语法错误

过往尝试无效的原因 #

你之前测试的路径中，\css\style.css是Windows系统的路径写法，Web服务环境不识别；不带仓库名的根路径/css/style.css会请求https://chxrain.github.io/css/style.css，该地址不存在，自然无法加载成功。 #

内容的提问来源于stack exchange，提问作者Mirana Chloe