本地可正常构建的类库在VSTS在线构建时缺失NuProj.props文件报错

我来帮你搞定这个头疼的问题！结合你说的本地和另一台电脑都能正常构建，但VSTS在线构建报错的情况，给你几个实用的排查方案：

• 确认VSTS构建流程的NuGet还原步骤配置
  大概率是构建前没执行NuGet还原！你得检查VSTS的构建任务列表，确保第一步就是NuGet还原任务，而不是直接跳去构建项目。还要注意：

  • 还原任务要指向正确的解决方案文件或者packages.config；
  • 选择的NuGet版本要和你本地使用的一致，比如本地用NuGet 5.x，就别在VSTS里选旧的3.x版本，版本不兼容也会导致还原失败。

• 检查Git仓库的.gitignore规则
  虽然你说已经检查过仓库，但还是得确认.gitignore里有没有写packages/。如果有这条，你的NuGet包文件根本没被提交到Git，VSTS构建时自然找不到对应的NuProj.props。如果是这种情况：

  • 不推荐直接提交整个packages文件夹（体积太大），优先确保NuGet还原步骤能正常工作；
  • 如果是用PackageReference格式的项目，packages文件夹本来就不会被提交，这时候必须依赖还原步骤拉取包。

• 生成并提交NuGet锁定文件
  对于用PackageReference的项目，你可以在本地运行：

  dotnet restore --locked-mode
  

  生成packages.lock.json文件，然后把这个文件提交到Git。这样VSTS构建时会严格按照锁定的包版本和来源还原，避免版本不一致导致的文件缺失。
  如果是旧的packages.config项目，先在本地执行nuget restore确保包都下载完整，然后检查NuProj.0.11.30/build/NuProj.props是否存在，并且没有被.gitignore排除。

• 清理VSTS代理的NuGet缓存
  有时候代理机器的NuGet缓存会有损坏，导致还原的包不完整。你可以在VSTS构建任务里加一个命令行步骤，先清理缓存：

  nuget locals all -clear
  

  然后再执行NuGet还原和项目构建。另外还要确认代理机器能正常访问你的NuGet源，如果是企业内部镜像源，要在VSTS的NuGet配置里设置正确的源地址。

• 检查项目文件的引用路径
  打开classes.csproj文件，找到引用NuProj的相关配置，确认路径是相对路径（比如..\packages\NuProj.0.11.30\build\NuProj.props），有没有硬编码本地的绝对路径。如果是绝对路径，VSTS代理上肯定找不到，改成相对路径就行。

按照上面的步骤逐一排查，应该能解决这个问题。如果还是不行，可以补充下VSTS构建任务的配置截图或者项目文件里的包引用代码，方便进一步分析。

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