配置predeploy、deploy及homepage后，gh-pages -d build仍执行失败

我已在package.json中配置好predeploy、deploy脚本以及homepage字段，但执行gh-pages -d build时仍出现错误。

错误截图：

相关package.json配置如下：

{
  "name": "vite-project",
  "private": true,
  "version": "0.0.0",
  "homepage": "https://rijuoddusual1999.github.io/simpleparallax",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "predeploy": "npm run build",
    "deploy": "gh-pages -d build",
    "lint": "eslint . --ext js,jsx --report-unused-disable-directives --max-warnings 0",
    "preview": "vite preview"
  }
}

我已多次尝试部署均失败，项目已逾期，急需解决该问题。

解决方案 #

1. 本地安装gh-pages依赖

全局安装的gh-pages易出现环境适配问题，优先本地安装：

npm install gh-pages --save-dev

2. 配置Vite的base路径

Vite部署到GitHub Pages必须指定base字段，与homepage中的仓库名保持一致。在vite.config.js/vite.config.ts中添加：

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react' // 根据你的框架替换对应插件

export default defineConfig({
  plugins: [react()],
  base: '/simpleparallax/' // 与homepage末尾的仓库名完全匹配
})

3. 确认Git仓库关联正确性

检查本地项目是否绑定目标GitHub仓库：

git remote -v

若未关联，执行绑定命令：

git remote add origin https://github.com/rijuoddusual1999/simpleparallax.git

4. 清理gh-pages部署缓存

清除之前的部署残留缓存：

npx gh-pages clean

5. 重新执行部署流程

直接运行预设脚本，它会自动先执行build操作：

npm run deploy

6. 检查GitHub Pages后台设置

进入GitHub仓库的「Settings」→「Pages」页面，确认源选择的是gh-pages分支的/root路径，配置完成后等待3-5分钟让页面生效。

7. 验证Git身份有效性

确保本地Git已正确登录GitHub，执行以下命令检查账号信息：

git config --global user.name
git config --global user.email

若身份异常，重新配置账号信息或通过git credential-manager-core configure（Windows）/git config --global credential.helper osxkeychain（Mac）重新登录。

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