Azure YAML流水线中NodeTool未生效，如何强制使用指定Node版本？

问题根源 #

你用sudo调用node/npm时，会切换到root用户环境，而NodeTool@0/UseNode@1是给当前构建用户安装并配置Node环境的，root用户的PATH并未包含任务安装的Node路径，所以调用的是系统默认的Node版本（v18.14.1）。

具体解决方案 #

1. 移除sudo（首选方案） #

构建任务本身拥有足够权限执行npm build等操作，无需使用sudo。修改后的流水线步骤如下：

steps:
  - task: NodeTool@0
    displayName: 'Install Node.js v16.19.0'
    inputs:
      versionSource: 'spec'
      versionSpec: '16.19.0'

  # 无需同时使用NodeTool@0和UseNode@1，两者功能重复
  # - task: UseNode@1
  #   displayName: 'use node v16.19.0'
  #   inputs:
  #     version: '16.19.0'

  - script: |
      node -v
    displayName: 'Node Version'
    workingDirectory: $(Build.SourcesDirectory)

  - script: |
      npm run build -- --mode $(NPM_BUILD_MODE)
    displayName: 'Building SPA with NPM'

2. 若必须使用sudo，指定Node完整路径 #

如果确实需要root权限，先获取当前构建用户的Node路径，再通过sudo调用该路径：

steps:
  - task: NodeTool@0
    displayName: 'Install Node.js v16.19.0'
    inputs:
      versionSource: 'spec'
      versionSpec: '16.19.0'

  - script: |
      NODE_BIN=$(which node)
      sudo $NODE_BIN -v
    displayName: 'Node Version'
    workingDirectory: $(Build.SourcesDirectory)

  - script: |
      NODE_BIN=$(which node)
      NPM_BIN=$(which npm)
      sudo $NODE_BIN $NPM_BIN run build -- --mode $(NPM_BUILD_MODE)
    displayName: 'Building SPA with NPM'

3. 验证环境配置（排查用） #

添加步骤打印PATH和Node路径，确认任务是否正确配置了环境：

- script: |
    echo "Current PATH:"
    echo $PATH
    echo "Node executable path:"
    which node
  displayName: 'Verify Node Environment'

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