使用Tailwind时GitHub Pages仅显示纯HTML，本地VS Code运行正常求助

核心排查方向及解决方法 #

• 验证CSS引用路径：检查HTML里的CSS链接是否使用了正确的相对路径。比如你的CSS文件在docs/css目录下，HTML中应该写 <link rel="stylesheet" href="./css/style.css">，别用绝对路径（比如/css/style.css）——GitHub Pages部署在仓库子路径下时，绝对路径会指向域名根目录而非你的项目文件夹。
• 确认Tailwind构建产物已提交：必须确保你执行了Tailwind的构建命令（比如npm run build），把编译好的完整CSS文件生成到docs文件夹里，并且这个文件已经提交到GitHub仓库。如果只传了未编译的源CSS文件，浏览器无法识别Tailwind的自定义指令，肯定没样式。
• 检查GitHub Pages部署状态：去仓库的「Settings -> Pages」页面看部署记录，如果有失败提示，根据提示修复（比如依赖没装全、构建命令写错）。
• 强制刷新清除缓存：浏览器可能缓存了旧页面，用Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（Mac）强制刷新，看看样式能不能加载出来。
• 核对Tailwind配置文件：如果tailwind.config.js不在项目根目录，要在构建命令里指定配置路径，确保Tailwind能扫描到docs里HTML文件的类名。比如在package.json的scripts里配置：

  "scripts": {
    "build": "tailwindcss -i ./src/input.css -o ./docs/css/style.css --config ./tailwind.config.js"
  }
  

内容的提问来源于stack exchange，提问作者Voke God'stime