MSBuild RestorePackagesPath参数用途及构建路径异常问询

为什么构建阶段会查找本地packages文件夹？ #

你的项目采用的是packages.config格式，这种格式的项目会在.csproj文件中硬编码包的相对路径（比如错误提示里的..\packages\EntityFramework.6.3.0\build\EntityFramework.props）。尽管你在restore阶段将包还原到了自定义的C:\NuGetPackages目录，但构建时MSBuild仍会严格按照项目文件中写死的相对路径去查找包，因此才会尝试访问C:\ProgramData\SampleProject\packages。

解决方法 #

方案1：迁移到PackageReference（推荐） #

PackageReference是NuGet的现代引用格式，它不会在项目文件中硬编码包路径，而是自动使用nuget.config中配置的globalPackagesFolder路径。迁移步骤：

• 右键项目 → 管理NuGet程序包 → 点击界面顶部的"迁移packages.config到PackageReference"按钮。

方案2：构建时指定PackagesPath参数 #

对于仍使用packages.config的项目，构建阶段需要通过PackagesPath参数告知MSBuild包的存储位置。修改后的构建命令如下：

"C:\Program Files\Microsoft Visual Studio\2022\Community\MSBuild\Current\Bin\MSBuild.exe" "C:\ProgramData\SampleProject\SampleProject.sln" /property:Configuration=Debug /p:RestoreConfigFile="C:\NuGetPackages\NuGet.Config" /p:PackagesPath="C:\NuGetPackages" -v:diag

方案3：修改项目文件中的路径（不推荐） #

手动编辑.csproj文件，将所有..\packages\开头的路径替换为C:\NuGetPackages\。这种方法需要逐个修改项目，维护成本高，仅适合临时应急。

RestorePackagesPath参数的用途 #

这个参数仅作用于NuGet的restore阶段，用于指定restore操作时包的下载目标目录。它对构建阶段没有影响，因此你在构建命令中添加该参数不会改变构建时的包查找逻辑。

• 对于packages.config项目：构建阶段依赖PackagesPath参数指定包位置；
• 对于PackageReference项目：构建时自动读取nuget.config中的globalPackagesFolder配置，无需额外参数。

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