求助：Github Pages部署后CSS不生效，本地运行正常

• 检查静态资源路径
  本地运行时的绝对路径（比如/css/style.css）在Github Pages上可能失效——因为你的站点部署在仓库子路径（如https://用户名.github.io/仓库名/），绝对路径会指向域名根目录而非你的站点目录。把路径改成相对路径（如./css/style.css），再打开浏览器开发者工具（F12）的Network标签，查看CSS文件的请求状态：如果是404，说明路径仍错误，需要对应调整。

• 确认docs文件夹结构
  确保docs目录下的文件层级正确，比如：

  docs/
  ├── index.html
  └── css/
      └── style.css
  

  静态资源要和HTML文件保持对应层级，不要嵌套多余文件夹（比如docs/static/css），除非HTML里的路径完全匹配这个结构。

• 修正Flask导出的静态页面路径
  如果你是通过Flask渲染模板后导出静态HTML，别用Flask自带的url_for('static', filename='css/style.css')生成路径——线上是纯静态站点，没有Flask的路由解析。直接在模板里写相对路径（如./css/style.css），再重新导出HTML文件到docs目录。

• 验证Github Pages部署设置
  进入仓库Settings -> Pages，确认部署来源是master分支的/docs文件夹，且页面顶部显示"Your site is live at..."。如果刚修改过设置，可能有部署延迟，等待几分钟后刷新站点。

• 排除浏览器缓存干扰
  按Ctrl+F5强制刷新页面，或者用无痕模式打开，避免浏览器缓存旧的无样式页面。

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