如何在Jenkins从节点安装并维护多版本Node.js、angular-cli与npm

一、用nvm顺便管好多版本npm #

npm本身和Node版本绑定，但也能为每个Node版本单独安装指定npm：

• 先安装目标Node版本：nvm install 16.18.0（替换成你需要的版本号）
• 切换到该Node版本：nvm use 16.18.0
• 安装指定npm版本：npm install -g npm@8.19.2
• 验证版本：npm -v，确认版本匹配
• 后续切换Node版本时，对应的npm会自动切换——nvm会把每个Node版本的全局包分开存储，互不干扰

二、多版本Angular CLI安装：两种实用方案 #

方法1：全局安装+别名，快速调用 #

• 先切换到对应Node/npm版本（避免版本不兼容）
• 安装指定Angular CLI并添加别名：npm install -g @angular/cli@14.2.10 ng14
• 重复步骤安装其他版本，比如：npm install -g @angular/cli@16.2.0 ng16
• 使用时直接调用别名：ng14 version、ng16 version

方法2：项目本地安装，最稳不冲突 #

无需维护全局版本，直接把Angular CLI装在项目内：

• 进入项目根目录，切换到对应Node/npm版本后执行：npm install --save-dev @angular/cli@14.2.10
• 运行命令时用npx调用本地版本：npx ng build（npx会自动识别项目内的ng命令）

三、Jenkins构建时自动切换版本流程 #

不管是Pipeline还是自由风格项目，在构建脚本中加入以下步骤即可：

1. 加载nvm环境 #

Jenkins默认shell可能识别不到nvm，脚本开头先加：

source ~/.nvm/nvm.sh  # 路径根据nvm实际安装位置调整，比如/usr/local/nvm/nvm.sh

2. 根据分支匹配对应版本 #

假设分支与版本对应关系如下：feature/ng14用Node16+ng14，main用Node18+ng16，写判断逻辑：

# 获取当前分支名
BRANCH_NAME=$(git rev-parse --abbrev-ref HEAD)

# 分支-版本映射
case $BRANCH_NAME in
  feature/ng14)
    nvm use 16.18.0
    NG_CMD="ng14"  # 全局别名模式用这行，本地安装模式可删除
    ;;
  main)
    nvm use 18.17.0
    NG_CMD="ng16"
    ;;
  *)
    echo "未配置该分支的对应版本：$BRANCH_NAME"
    exit 1
    ;;
esac

# 验证版本正确性
node -v
npm -v
$NG_CMD version  # 本地安装模式替换为 npx ng version

3. 执行构建命令 #

以Angular项目构建为例：

# 全局别名模式
$NG_CMD build --prod

# 本地安装模式
npx ng build --prod

四、踩坑提醒 #

• 确保Jenkins运行用户（如jenkins用户）有权限访问nvm及全局npm包目录，避免权限报错
• 首次安装各版本时，手动在从节点执行一遍命令，确认安装成功后再配置Jenkins任务
• 频繁切换版本场景优先选项目本地安装Angular CLI，避免全局版本冲突
• 可将分支-版本对应关系写入配置文件（如version-map.json），脚本读取该文件，后续修改版本无需改动脚本

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