Vite构建的Tailwind项目本地正常，部署GitHub Pages后失效求助

1. 配置Vite的base路径 #

因为你的GitHub Pages部署在子路径/portfolio-build/，必须在vite.config.js中指定正确的base：

import { defineConfig } from 'vite'

export default defineConfig({
  base: '/portfolio-build/',
  // 其他原有配置
})

2. 验证Tailwind配置的文件范围 #

检查tailwind.config.js的content字段，确保覆盖所有需要编译的文件，避免样式未被生成：

export default {
  content: [
    "./index.html",
    "./src/**/*.{js,jsx,ts,tsx}",
  ],
  // 主题、插件等其他配置
}

3. 确认资源引用路径 #

确保index.html中没有手动写死绝对路径的资源引用，Vite构建后会自动生成正确的相对路径，不要修改这些自动生成的引用。

4. 重新构建并部署 #

• 执行npm run build重新生成dist目录
• 检查GitHub Pages的部署设置，确认是从gh-pages分支的/dist目录读取部署文件（如果用了部署脚本，确保脚本正确推送dist目录内容到gh-pages分支）

5. 强制刷新清除缓存 #

部署完成后，按Ctrl+F5强制刷新浏览器，避免加载旧的缓存资源。

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