Windows Runner上Bitbucket Pipeline无法通过nvm切换Node.js版本咨询

核心原因 #

nvm-windows是通过修改当前shell的环境变量实现Node版本切换的，但Bitbucket Pipeline的每个步骤都是独立的子进程，环境变量无法跨步骤继承；且直接执行nvm use后，当前shell的环境变量不会自动刷新，导致后续命令无法识别新的Node版本。

可行解决方案 #

方案1：同一步骤内完成切换与操作 #

将版本切换命令、环境变量刷新命令和业务命令放在同一个step中，确保环境变量在当前进程生效：

pipelines:
  default:
    - step:
        runs-on: windows
        script:
          - |
            nvm use 16.15.0
            # 重新加载系统+用户级环境变量，让当前进程识别新的Node路径
            $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
            node -v  # 验证版本是否切换成功
            npm install  # 后续业务命令

方案2：用nvm exec直接指定版本执行命令 #

nvm exec可以跳过手动切换步骤，直接在指定Node版本环境下运行目标命令，无需处理环境变量问题：

pipelines:
  default:
    - step:
        runs-on: windows
        script:
          - nvm exec 16.15.0 node -v  # 直接在16.15.0环境下执行命令
          - nvm exec 6.9.1 npm run build  # 切换到6.9.1环境执行构建

方案3：预配置Runner默认版本（固定版本场景） #

如果Pipeline长期使用特定Node版本，可在Runner上提前设置默认版本，避免每次切换：

1. 手动登录Windows Runner，执行nvm alias default 16.15.0
2. 重启Bitbucket Runner服务，确保默认版本生效
3. Pipeline中直接使用node/npm命令即可，无需额外切换操作

验证方式 #

在每个方案的step中添加版本验证命令，确认切换结果：

script:
  - nvm exec 6.9.1 node -v  # 预期输出v6.9.1

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