Azure DevOps自托管代理执行npm install失败：无法定位npm可执行文件

• 重启自托管代理服务
  代理启动时会加载当时的系统环境变量，你后来添加的Node.js路径没被代理读取到。直接在代理安装目录运行命令重启：
  Windows: .\run.cmd restart
  Linux/macOS: ./run.sh restart
  或者通过系统服务列表找到Azure Pipelines Agent服务，右键选择重启。

• 修正代理能力的npm路径
  手动添加npm能力时，Windows系统要指定npm.cmd的完整路径（比如C:\Program Files\nodejs\npm.cmd），不能只填npm；Linux/macOS直接填npm的绝对路径（比如/usr/local/bin/npm）。添加完成后必须重启代理，让配置生效。

• 在YAML中强制注入Node.js路径
  如果上面的方法都没效果，直接在npm任务前手动把Node.js目录加入PATH：

steps:
- script: |
    set PATH=C:\Program Files\nodejs;%PATH%
  displayName: '手动添加Node.js到PATH（Windows）'
- task: Npm@1
  inputs:
    command: 'install'

Linux/macOS版本替换成：

steps:
- script: |
    export PATH=/usr/local/bin/node:$PATH
  displayName: '手动添加Node.js到PATH（Linux/macOS）'
- task: Npm@1
  inputs:
    command: 'install'

另外也可以用官方的NodeTool任务自动配置环境，前提是代理机器能访问下载源：

- task: NodeTool@0
  inputs:
    versionSpec: '18.x' # 替换成你本地安装的Node.js版本
  displayName: '配置Node.js环境'
- task: Npm@1
  inputs:
    command: 'install'

• 验证代理机器的本地环境
  在代理机器的命令行里执行where npm（Windows）或which npm，如果返回空，说明系统PATH配置根本没生效。重新把Node.js的安装目录（比如C:\Program Files\nodejs）加到系统PATH，然后重启整个机器，再验证路径是否正常。

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