Windows环境运行npm run build报部署错误 执行npm run deploy报错如何解决

• 第一步：排查依赖安装问题
  多数部署报错是未安装部署所需的gh-pages依赖导致，执行如下命令将其安装到项目开发依赖即可：

  npm install gh-pages --save-dev
  

• 第二步：校验package.json配置
  1. 确认homepage字段配置正确，若部署到GitHub Pages，格式为https://<用户名>.github.io/<仓库名>/
  2. 确认scripts字段下的deploy命令配置正确，注意打包产物路径要和实际生成的目录匹配，示例正确配置：

  "scripts": {
    "build": "react-scripts build",
    "deploy": "gh-pages -d build"
  }
  

  如果你项目打包生成的是dist目录，需要将-d后的参数改为dist
• 第三步：排查Git环境问题
  执行deploy前需确保本地已完成Git仓库初始化，且已关联正确的远程仓库，执行以下命令校验：

  git remote -v
  

  若无输出，需先执行Git初始化和远程关联操作：

  git init
  git remote add origin <你的远程仓库地址>
  

• 第四步：解决Windows权限/环境问题
  1. 优先使用管理员权限启动终端（PowerShell/CMD）再执行部署命令，避免系统权限限制
  2. 若之前构建就已报错，先清理环境重新安装依赖：

  npm cache clean --force
  # Windows系统若rm命令不可用，替换为 rd /s /q node_modules 和 del package-lock.json
  rm -rf node_modules package-lock.json
  npm install
  

  先执行npm run build确认打包成功、产物目录正常生成后，再执行npm run deploy
• 第五步：校验远程推送权限
  确认你对目标远程仓库有推送权限，若使用HTTPS协议关联仓库，确保本地已保存正确的Git凭证；若使用SSH协议，确认本地SSH公钥已添加到对应代码托管平台。

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