如何在VSTS托管构建代理的PowerShell任务中运行自定义npm命令？

我之前在Azure DevOps托管构建代理的PowerShell任务里也碰到过类似的npm命令执行失效问题，试了几个靠谱的方法，给你整理下：

• 先刷新环境变量，确保npm可全局调用
  托管代理的PowerShell会话有时候不会自动加载完整的系统环境变量，导致找不到npm。可以先调用系统的RefreshEnv.cmd来刷新，再执行npm命令：

& "$env:windir\system32\cmd.exe" "/c" "RefreshEnv.cmd"
npm run your-custom-script

• 确保工作目录指向package.json所在位置
  很多时候问题出在PowerShell的工作目录不对，npm找不到你的package文件。可以先切换到项目根目录（用Azure DevOps预定义变量更稳妥）：

cd $(Build.SourcesDirectory)\path-to-your-package-json-folder
npm run your-custom-script

这里的$(Build.SourcesDirectory)是Azure DevOps内置变量，会自动指向当前构建的源代码根目录，不用硬编码路径。

• 用PowerShell的调用操作符&执行完整路径的npm.cmd
  如果直接调用npm不行，试试指定npm.cmd的完整路径，记得用&来执行带空格路径的可执行文件：

& "C:\Program Files\nodejs\npm.cmd" run your-custom-script

如果是32位版本的nodejs，路径可能是C:\Program Files (x86)\nodejs\npm.cmd，可以根据代理实际情况调整。

• Invoke-Expression的正确用法
  如果你坚持用Invoke-Expression，要注意命令字符串的引号转义，确保PowerShell能正确解析：

$npmCmd = "C:\Program Files\nodejs\npm.cmd"
$script = "your-custom-script"
Invoke-Expression -Command "& '$npmCmd' run $script"

• 额外排查步骤
  • 先确认node和npm的版本是否符合要求，在PowerShell里执行node --version和npm --version查看；如果版本不对，可以先添加一个「Node Tool Installer」任务来指定所需版本。
  • 加上--verbose参数运行npm命令，获取详细日志，方便定位脚本执行失败的具体原因：

    npm run your-custom-script --verbose
    

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