我的GitHub Pages站点CSS样式不生效问题求助

排查及解决步骤 #

• 路径大小写校验：GitHub Pages 服务端对文件路径大小写敏感，本地开发环境（Windows、macOS默认）大小写不敏感不会触发问题，但线上会直接返回404。请完全匹配CSS文件的实际路径大小写，比如路径写为./css/index.css就必须保证实际文件路径是小写css文件夹下的小写index.css文件。
• 站点路径适配：如果你的站点是项目类站点，不能直接使用根路径写法/style.css，该路径会指向根域名下的资源，而非当前项目目录下。请改为相对路径写法./style.css，或者带上项目前缀/tech/style.css。
• link标签属性校验：确认HTML中引入CSS的link标签已添加rel="stylesheet"属性，缺省该属性时浏览器不会将返回的文件识别为样式表解析，正确示例为<link rel="stylesheet" href="你的CSS文件路径">。
• 缓存与部署延迟排查：GitHub Pages 部署更新通常有3-10分钟的延迟，提交代码后不要立即刷新验证。本地浏览器可使用Ctrl+Shift+R（Mac为Cmd+Shift+R）强制跳过缓存刷新，或开启无痕模式访问验证。
• 浏览器控制台排查：按下F12打开浏览器开发者工具，切换到「网络」标签页刷新页面，查看CSS资源的加载状态：
  • 若返回404状态码，回到前两步重新核对路径配置
  • 若返回200但样式未生效，检查响应头的MIME类型是否为text/css，如果MIME类型错误，确认你的CSS文件后缀为.css，没有出现.css.txt这类系统隐藏后缀的情况。

内容的提问来源于stack exchange，提问作者LEEVANCE SINGH