配置GitHub Pages部署时出现npm deploy missing script错误如何解决

问题原因 #

你的报错Missing script: "deploy"和你安装的Node v17、npm v8版本无关，属于依赖安装错误、package.json配置缺失或执行路径错误导致的，按照以下步骤修复即可：

• 修正依赖安装
  你之前执行的npm install deploy是无效操作，部署GitHub Pages需要安装gh-pages开发依赖，执行以下命令安装：

npm install gh-pages --save-dev

• 校验package.json配置
  打开项目根目录的package.json文件，确认以下两个配置都正确添加：

1. 根级别添加homepage字段（替换为你自己的GitHub用户名和仓库名）：

"homepage": "https://<你的GitHub用户名>.github.io/<你的仓库名>",

2. 在scripts字段内添加predeploy和deploy脚本，不要修改原有其他脚本：

"scripts": {
  "start": "react-scripts start",
  "build": "react-scripts build",
  // 上面是原有默认脚本，新增下面两个
  "predeploy": "npm run build",
  "deploy": "gh-pages -d build"
}

注意严格遵循JSON语法，字段之间不要漏逗号，也不要在最后一个字段末尾多加逗号，避免JSON解析失败。

• 确认执行命令的路径
  执行命令前确认当前终端的工作目录是项目根目录，也就是你刚才修改的package.json所在的目录，你的日志中当前工作目录为/Users/reallymemorable/git/roo，请确认该目录下的package.json已经完成上述配置。

• 验证并执行部署
  配置完成后执行npm run命令，即可看到所有可用的npm脚本，确认列表中出现deploy后，再执行npm run deploy即可正常触发部署。

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