VSTS构建定义本地正常，执行时出现Dotnet命令非零退出码错误

我之前也碰到过一模一样的情况——本地构建顺风顺水，一到VSTS的CI流程就报Dotnet命令非零退出码，大概率是本地环境和构建代理环境的差异导致的，给你列几个我亲测有效的排查和解决方向：

1. 核对构建代理的.NET SDK版本 #

本地能正常构建，不代表构建代理上的SDK版本和你开发环境匹配。你可以先在构建定义里加一个临时的命令行步骤，执行：

dotnet --version

把代理使用的SDK版本和你本地的版本对比一下。如果版本不兼容：

• 要么在构建流程里添加「Use .NET Core」任务，指定和本地一致的SDK版本（比如6.x或7.x），让代理先下载对应版本再执行构建；
• 要么调整项目的目标框架（修改.csproj里的TargetFramework节点），确保和代理上的SDK兼容。

2. 确认依赖包能在代理环境正常还原 #

本地的NuGet缓存可能已经包含了所有依赖，但构建代理是干净的环境，很可能出现私有源未配置、包权限不足的问题：

• 一定要在构建步骤前添加「NuGet还原」任务，确保所有依赖都先下载完成再执行构建；
• 如果项目用到了私有NuGet源，记得在VSTS的「服务连接」里配置好这个源，并在NuGet还原任务中选中它，避免代理找不到私有包。

3. 对齐本地和CI的构建参数 #

有时候本地构建用了特定参数（比如dotnet build --configuration Release --runtime win-x64），但VSTS的构建任务里漏加了这些参数，导致构建逻辑不一致：

• 把你本地执行的构建命令完整复制出来，和VSTS中「Dotnet Build」任务的参数逐一比对，确保配置（比如构建配置、目标运行时、输出目录）完全一致。

4. 查看详细构建日志定位具体错误 #

默认的错误提示只说了非零退出码，没给出具体原因。你可以：

1. 打开构建定义的「选项」页面；
2. 把「日志详细程度」改成「详细」；
3. 重新触发构建，查看完整的日志输出。

我之前就是通过详细日志发现，项目里引用了一个本地的私有DLL，本地有但代理环境里没有，日志里明确显示「找不到文件」，补上这个文件就解决了问题。

5. 检查构建代理的工作目录权限 #

偶尔会碰到代理对工作目录（比如D:\a\1\s\）没有读写权限的情况，导致无法生成输出文件或写入临时文件：

• 可以加一个命令行步骤，执行dir D:\a\1\s\My.Project\查看目录结构是否正确；
• 如果有条件，直接在代理机器上手动执行构建命令，模拟CI环境，更容易定位权限或路径问题。

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