React项目GitHub Actions执行npm run build报Missing script错误求助

以下是几个实用的排查方向和解决办法：

1. 检查工作流的工作目录 #

GitHub Actions默认在仓库根目录执行命令，若你的package.json不在根目录（比如放在client/这类子文件夹），会导致找不到脚本。需在执行npm run build前切换到对应目录：

- name: Build project
  working-directory: ./client
  run: npm run build

2. 确保install和build使用同一目录 #

如果npm install是在子目录执行，但npm run build在根目录运行，也会出现该问题。保证两个步骤的工作目录一致：

- name: Install dependencies
  working-directory: ./client
  run: npm install
- name: Build project
  working-directory: ./client
  run: npm run build

3. 排查.gitignore规则 #

若package.json被误加入.gitignore，GitHub Actions拉取代码时会忽略该文件。检查你的.gitignore，确保没有包含package.json。

4. 验证拉取的代码完整性 #

在工作流中添加步骤，打印当前目录文件列表和package.json内容，确认文件存在且脚本配置正确：

- name: Check package.json status
  run: |
    ls -la
    cat package.json

5. 清理npm缓存（应急方案） #

缓存异常偶尔会引发这类问题，可在npm install前清理缓存：

- name: Clean npm cache
  run: npm cache clean --force
- name: Install dependencies
  run: npm install

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