Bitbucket Pipeline多步骤缓存失效：依赖无法复用致Prettier找不到

问题原因 #

当前配置中，尽管每个步骤都启用了指向node_modules的node缓存，但后续步骤仍找不到prettier这类依赖，核心原因有两点：

1. Bitbucket Pipeline的每个步骤是独立Docker容器，默认node_modules/.bin不在系统PATH中，直接调用依赖命令会提示找不到
2. 缓存的更新时机是步骤执行完毕后，第一个步骤安装依赖后缓存才会被写入，后续步骤读取缓存本身是可行的，但PATH配置缺失导致无法调用依赖中的命令

解决方案 #

方案1：补全PATH配置，确保依赖命令可被调用 #

修改Pipeline配置，在执行npm脚本的步骤中，将node_modules/.bin加入系统PATH，这样就能直接调用依赖中的命令：

image: node:20

pipelines:
  pull-requests:
    '**':
      - step: 
          name: Install Dependencies
          caches:
            - node  
          script:
            - npm install  
      - step:
          name: Checking Format
          caches:
            - node  
          script:
            - export PATH="$PATH:./node_modules/.bin"
            - npm run format-check

      - step:
          name: Run Tests
          caches:
            - node  
          script:
            - export PATH="$PATH:./node_modules/.bin"
            - npm run test

definitions:
  caches:
    node: node_modules 

方案2：修改npm脚本，用npx调用依赖 #

无需修改Pipeline配置，直接调整package.json中的脚本，用npx自动查找node_modules/.bin中的命令：

{
  "scripts": {
    "format-check": "npx prettier --check \"**/*.{ts,tsx}\"",
    "test": "npx jest" // 根据实际测试框架调整
  }
}

方案3：合并步骤（可选） #

如果不需要拆分步骤的独立报告，可以将安装依赖、格式检查、测试合并到同一个步骤，避免跨步骤缓存的问题：

image: node:20

pipelines:
  pull-requests:
    '**':
      - step: 
          name: Install & Verify
          caches:
            - node  
          script:
            - npm install
            - npm run format-check
            - npm run test

definitions:
  caches:
    node: node_modules 

验证方法 #

可以在步骤中添加调试命令，确认缓存和PATH配置是否生效：

• 查看node_modules是否存在：ls -la node_modules
• 查看当前PATH：echo $PATH
• 直接检查依赖命令是否可调用：which prettier

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