tansci-boot/antdv-next-admin/DEPLOYMENT.md

GitHub Pages 部署指南

本项目已配置为可自动部署到 GitHub Pages。

📦 部署地址

• 生产环境: https://yelog.github.io/antdv-next-admin/

🚀 自动部署

项目使用 GitHub Actions 实现自动化部署：

1. 当代码推送到 main 分支时，会自动触发部署流程
2. GitHub Actions 会自动构建项目并部署到 GitHub Pages
3. 部署完成后，可以通过上述地址访问

⚙️ 配置说明

1. Vite 配置

// vite.config.ts
base: process.env.NODE_ENV === 'production' ? '/antdv-next-admin/' : '/'

2. GitHub Actions

• 工作流文件: .github/workflows/deploy.yml
• 触发条件: 推送到 main 分支或手动触发
• 构建命令: npm run build

3. SPA 路由支持

• public/404.html: 处理 404 重定向
• index.html: 接收重定向并恢复路由
• public/.nojekyll: 禁用 Jekyll 处理

📝 手动部署步骤

如果需要手动部署：

# 1. 构建项目
npm run build

# 2. 进入构建目录
cd dist

# 3. 初始化 git 仓库
git init
git add -A
git commit -m 'deploy'

# 4. 推送到 gh-pages 分支
git push -f git@github.com:yelog/antdv-next-admin.git main:gh-pages

# 5. 返回项目根目录
cd -

🔧 GitHub 仓库设置

确保在 GitHub 仓库设置中：

1. 进入仓库 Settings → Pages
2. Source 选择 "GitHub Actions"
3. 等待首次部署完成

📊 查看部署状态

• 在 GitHub 仓库的 "Actions" 标签页查看部署进度
• 绿色勾号表示部署成功
• 红色叉号表示部署失败，点击查看日志

🐛 常见问题

1. 404 错误

• 确保 base 配置正确
• 检查 GitHub Pages 设置是否正确

2. 路由不工作

• 确保 404.html 和 index.html 中的重定向脚本存在
• 检查浏览器控制台是否有错误

3. 样式/资源 404

• 确保 base 路径配置正确
• 检查构建后的资源路径是否正确

🔐 权限说明

GitHub Actions 需要以下权限：

• contents: read - 读取代码
• pages: write - 写入 Pages
• id-token: write - 身份验证

这些权限已在 workflow 文件中配置。