部署React应用至GitHub Pages报错：无法找到git

我正在开发一款React应用，尝试使用gh-pages Node模块将其部署到GitHub Pages。我的package.json配置如下：

{"name": "personal-website","version": "0.1.0","private": true,"homepage": "https://virajkumar.github.io/","dependencies": {"@testing-library/jest-dom": "^5.17.0","@testing-library/react": "^13.4.0","@testing-library/user-event": "^13.5.0","react": "^18.3.1","react-dom": "^18.3.1","react-redux": "^9.1.2","react-router": "^6.26.1","react-router-dom": "^6.26.1","react-scripts": "5.0.1","redux": "^5.0.1","web-vitals": "^2.1.4","webpack": "^5.93.0"},"scripts": {"start": "react-scripts start","build": "react-scripts build","test": "react-scripts test","eject": "react-scripts eject","predeploy": "npm run build","deploy": "gh-pages -d build"},"eslintConfig": {"extends": ["react-app","react-app/jest"]},"browserslist": {"production": [">0.2%","not dead","not op_mini all"],"development": ["last 1 chrome version","last 1 firefox version","last 1 safari version"]},"devDependencies": {"gh-pages": "^6.1.1"}}

执行npm run deploy时遇到以下错误：

> personal-website@0.1.0 deploy
> gh-pages -d build
 
node:events:368
    throw er // Unhandled 'error' event

Error: spawn git ENOENT
    at Process.ChildProcess._handle.onexit (node:internal/child_process:282:19)
    at onErrorNT (node:internal/child_process:477:16)
    at processTicksAndRejections (node:internal/process/task_queues:83:21)
Emitted 'error' event on ChildProcess instance at:
    at Process.ChildProcess._handle.onexit (node:internal/child_process:288:12)
    at onErrorNT (node:internal/child_process:477:16)
    at processTicksAndRejections (node:internal/process/task_queues:83:21) {
  errno: -2,
  code: 'ENOENT',
  syscall: 'spawn git',
  path: 'git',
  spawnargs: [ 'clean', '-f', '-d' ]
}

我已经更新PATH变量指向Git可执行文件的路径，但错误依然存在，求解决办法。

这个错误的核心是Node.js无法找到Git的可执行文件，即便你更新了PATH，也可能存在环境变量未生效、路径配置不完整等问题，试试以下步骤：

1. 确认Git是否真的能在终端正常运行 #

打开系统原生终端（不要用IDE内置终端），输入git --version：

• 如果能输出Git版本号，说明Git本身没问题；如果报错，重新检查PATH配置：
  • Windows：确保C:\Program Files\Git\cmd（或你的Git安装路径下的cmd文件夹）添加到系统PATH（不是用户PATH），添加后重启终端。
  • macOS/Linux：执行which git查看路径，确认该路径在PATH中（执行echo $PATH检查）。

2. 直接在deploy命令中指定Git绝对路径 #

如果PATH配置正确但Node还是找不到，可以强制指定Git路径：

• Windows修改package.json的deploy脚本：

  "deploy": "gh-pages -d build --git \"C:\\Program Files\\Git\\cmd\\git.exe\""
  

• macOS/Linux修改：

  "deploy": "gh-pages -d build --git \"/usr/bin/git\""
  

  替换成你实际的Git可执行文件路径。

3. 刷新IDE终端的环境变量 #

如果你用VS Code、WebStorm等IDE的内置终端，关闭IDE再重新打开，确保终端加载最新的PATH配置。Windows用户还可以尝试以管理员身份运行IDE。

4. 重装gh-pages并清理缓存 #

执行以下命令：

npm uninstall gh-pages
npm cache clean --force
npm install gh-pages --save-dev

然后再次运行npm run deploy。

5. 确认本地Git仓库配置正确 #

确保你的项目已经关联GitHub远程仓库：

# 初始化仓库（如果还没做）
git init
# 关联远程仓库（替换成你的仓库地址）
git remote add origin https://github.com/virajkumar/virajkumar.github.io.git
# 提交一次代码
git add .
git commit -m "Prepare for deployment"

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