GitHub Pages部署个人站点CSS不加载，本地正常求助

核心排查方向及修复方法 #

• 大小写不匹配：GitHub Pages运行在Linux环境，严格区分文件/文件夹大小写，而本地Windows/macOS通常不区分。检查HTML中<link>标签的CSS路径，确保和GitHub仓库里的文件名称（包括大小写）完全一致。比如仓库里是styles.css，代码里就不能写成Styles.css。
• 相对路径错误：避免使用以/开头的绝对路径，这类路径会指向https://dewansh28.github.io/而非你的项目根目录https://dewansh28.github.io/PersonalSite/。正确的相对路径要基于HTML文件的位置：
  • 若HTML和CSS在同一目录：用./style.css或style.css
  • 若CSS在css子文件夹：用./css/style.css或css/style.css
• 文件缺失或上传不全：直接访问CSS的完整URL（比如https://dewansh28.github.io/PersonalSite/[你的CSS路径]），如果返回404错误，说明CSS文件没上传到仓库，或者路径写错了，需要重新上传文件并修正路径。
• 浏览器缓存干扰：按Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（macOS）强制刷新页面，清除浏览器缓存后再验证效果。

快速操作步骤 #

1. 打开你的HTML文件，找到CSS引用代码，示例：

   <link rel="stylesheet" href="css/style.css">
   

2. 对照GitHub仓库的文件结构，确认路径的大小写、层级完全匹配。
3. 将路径调整为正确的相对路径，避免绝对路径。
4. 提交修改到GitHub，等待1-2分钟让Pages更新，再访问站点查看。

内容的提问来源于stack exchange，提问作者Dewansh Saboo