本地VSTS Agent执行npm install无法安装全部NPM包（2018-02-28更新）

我来帮你梳理几个针对这个问题的排查方向，都是实际场景中验证有效的思路：

• 检查Agent的运行权限
  VSTS Agent默认常以系统服务身份运行，和你手动登录的用户权限环境完全不同。比如服务账户可能没有访问私有npm源的权限，或者对项目目录、node_modules目录没有足够的读写权限。你可以尝试：

  • 把Agent的运行账户改成你手动执行命令时使用的用户
  • 给Agent服务账户添加项目根目录和npm缓存目录的读写权限

• 对比环境变量与npm配置差异
  手动执行和Agent执行时的环境变量、npm配置可能存在差异，这会直接影响包的安装行为。建议在构建流程中添加两个步骤：

  • 执行 npm config list 输出当前Agent使用的npm配置
  • 执行 echo %PATH%（Windows）查看环境变量
    把这些结果和你手动在机器上执行的输出对比，重点关注registry、proxy、cache路径这些关键配置。

• 开启详细日志排查细节
  默认的构建日志可能不够细致，你可以调整构建定义的日志级别为「详细」，这样能看到npm install执行过程中的每一条输出。很多时候看似没有报错，但日志里会隐藏部分包下载失败、跳过安装的细节，这能帮你定位具体是哪些包出了问题。

• 清理缓存并重置Agent工作目录
  缓存损坏或者Agent工作目录的残留文件也可能导致这类问题：

  • 在构建步骤中添加 npm cache clean --force 清理npm缓存
  • 停止VSTS Agent服务，删除Agent安装目录下的_work文件夹，然后重新启动Agent，让它重新初始化工作环境

• 确认Node.js版本一致性
  虽然你已经运行了Install-NodeLts.ps1，但要确保Agent实际使用的Node.js和npm版本和你手动执行时完全一致。可以在构建流程中添加node -v和npm -v步骤，对比手动执行的版本，版本不一致可能会引发安装逻辑的差异。

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