Bitbucket Pipeline构建React项目报错：webpack: not found

1. 补装webpack-cli依赖 #

webpack 4.x及以上版本需要单独安装webpack-cli才能执行构建命令，即使已安装webpack也无法直接运行。

• 本地执行命令安装开发依赖：npm install --save-dev webpack-cli
• 提交更新后的package.json和package-lock.json到代码仓库，确保Pipeline安装阶段能同步获取该依赖。

2. 修正package.json的build脚本 #

确保build脚本正确调用本地webpack，可直接指定node_modules内的执行路径避免PATH问题：

"scripts": {
  "build": "./node_modules/.bin/webpack --mode production"
}

或者用npx强制调用本地依赖：

"scripts": {
  "build": "npx webpack --mode production"
}

3. 确保Pipeline完整安装开发依赖 #

默认情况下，npm install在NODE_ENV=production环境会跳过devDependencies，而webpack、webpack-cli通常是开发依赖。需在Pipeline中显式指定安装所有依赖：
在bitbucket-pipelines.yml的构建步骤中修改为：

script:
  - npm install --include=dev
  - npm run build

或者先切换到开发环境再安装：

script:
  - export NODE_ENV=development
  - npm install
  - npm run build

4. 清理Pipeline缓存 #

若存在缓存损坏导致依赖缺失的情况，可清理后重新安装：

pipelines:
  default:
    - step:
        script:
          - rm -rf node_modules package-lock.json
          - npm install --include=dev
          - npm run build

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