执行nuget pack时MSBuild命名空间错误的解决求助
.NET 4.7.2类库执行
nuget pack时出现命名空间错误排查与解决 问题背景
用VS 2022创建了.NET 4.7.2类库,按照官方文档流程准备NuGet包。和.NET 6类库不同,该项目没有一键打包的项目属性选项。运行nuget pack命令时触发错误:“项目的默认XML命名空间必须是MSBuild XML命名空间”。检查项目CSPROJ文件后,确认<Project>元素已经包含正确的MSBuild 2003命名空间,错误提示毫无参考价值,且该问题场景与常见问答案例不同——它是在执行nuget pack时触发的。
相关文件内容
项目CSPROJ文件
<?xml version="1.0" encoding="utf-8"?> <Project ToolsVersion="15.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003"> <Import Project="$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props" Condition="Exists('$(MSBuildExtensionsPath)\$(MSBuildToolsVersion)\Microsoft.Common.props')" /> <PropertyGroup> <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration> <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform> <ProjectGuid>{6A38AC27-E82D-47CF-B1C6-D987D7BCAE0C}</ProjectGuid> <OutputType>Library</OutputType> <AppDesignerFolder>Properties</AppDesignerFolder> <RootNamespace>CodaRESTClient.NET</RootNamespace> <AssemblyName>CodaRESTClient.NET</AssemblyName> <TargetFrameworkVersion>v4.7.2</TargetFrameworkVersion> <FileAlignment>512</FileAlignment> <Deterministic>true</Deterministic> <NuGetPackageImportStamp> </NuGetPackageImportStamp> </PropertyGroup> <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' "> <DebugSymbols>true</DebugSymbols> <DebugType>full</DebugType> <Optimize>false</Optimize> <OutputPath>bin\Debug\</OutputPath> <DefineConstants>DEBUG;TRACE</DefineConstants> <ErrorReport>prompt</ErrorReport> <WarningLevel>4</WarningLevel> </PropertyGroup> <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' "> <DebugType>pdbonly</DebugType> <Optimize>true</Optimize> <OutputPath>bin\Release\</OutputPath> <DefineConstants>TRACE</DefineConstants> <ErrorReport>prompt</ErrorReport> <WarningLevel>4</WarningLevel> </PropertyGroup> <PropertyGroup> <ApplicationIcon>Coda Logo - Image only.ico</ApplicationIcon> </PropertyGroup> <ItemGroup> <Reference Include="Microsoft.Bcl.AsyncInterfaces, Version=6.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51, processorArchitecture=MSIL"> <HintPath>..\packages\Microsoft.Bcl.AsyncInterfaces.6.0.0\lib\net461\Microsoft.Bcl.AsyncInterfaces.dll</HintPath> </Reference> <Reference Include="Newtonsoft.Json, Version=13.0.0.0, Culture=neutral, PublicKeyToken=30ad4fe6b2a6aeed, processorArchitecture=MSIL"> <HintPath>..\packages\Newtonsoft.Json.13.0.1\lib\net45\Newtonsoft.Json.dll</HintPath> </Reference> <Reference Include="RestSharp, Version=108.0.1.0, Culture=neutral, PublicKeyToken=598062e77f915f75, processorArchitecture=MSIL"> <HintPath>..\packages\RestSharp.108.0.1\lib\netstandard2.0\RestSharp.dll</HintPath> </Reference> <Reference Include="System" /> <Reference Include="System.Buffers, Version=4.0.3.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51, processorArchitecture=MSIL"> <HintPath>..\packages\System.Buffers.4.5.1\lib\net461\System.Buffers.dll</HintPath> </Reference> <Reference Include="System.Core" /> <Reference Include="System.Memory, Version=4.0.1.1, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51, processorArchitecture=MSIL"> <HintPath>..\packages\System.Memory.4.5.4\lib\net461\System.Memory.dll</HintPath> </Reference> <Reference Include="System.Numerics" /> <Reference Include="System.Numerics.Vectors, Version=4.1.4.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL"> <HintPath>..\packages\System.Numerics.Vectors.4.5.0\lib\net46\System.Numerics.Vectors.dll</HintPath> </Reference> <Reference Include="System.Runtime.CompilerServices.Unsafe, Version=6.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a, processorArchitecture=MSIL"> <HintPath>..\packages\System.Runtime.CompilerServices.Unsafe.6.0.0\lib\net461\System.Runtime.CompilerServices.Unsafe.dll</HintPath> </Reference> <Reference Include="System.Text.Encodings.Web, Version=6.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51, processorArchitecture=MSIL"> <HintPath>..\packages\System.Text.Encodings.Web.6.0.0\lib\net461\System.Text.Encodings.Web.dll</HintPath> </Reference> <Reference Include="System.Text.Json, Version=6.0.0.6, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51, processorArchitecture=MSIL"> <HintPath>..\packages\System.Text.Json.6.0.6\lib\net461\System.Text.Json.dll</HintPath> </Reference> <Reference Include="System.Threading.Tasks.Extensions, Version=4.2.0.1, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51, processorArchitecture=MSIL"> <HintPath>..\packages\System.Threading.Tasks.Extensions.4.5.4\lib\net461\System.Threading.Tasks.Extensions.dll</HintPath> </Reference> <Reference Include="System.ValueTuple, Version=4.0.3.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51, processorArchitecture=MSIL"> <HintPath>..\packages\System.ValueTuple.4.5.0\lib\net47\System.ValueTuple.dll</HintPath> </Reference> <Reference Include="System.Web" /> <Reference Include="System.Xml.Linq" /> <Reference Include="System.Data.DataSetExtensions" /> <Reference Include="Microsoft.CSharp" /> <Reference Include="System.Data" /> <Reference Include="System.Net.Http" /> <Reference Include="System.Xml" /> </ItemGroup> <ItemGroup> <Compile Include="Client.cs" /> <Compile Include="Client_Comment.cs" /> <Compile Include="Client_Discussion.cs" /> <Compile Include="Client_Errors.cs" /> <Compile Include="Client_Moderator.cs" /> <Compile Include="Client_Subscriptions.cs" /> <Compile Include="Client_Troubleshoot.cs" /> <Compile Include="Client_Vote.cs" /> <Compile Include="Properties\AssemblyInfo.cs" /> <Compile Include="SerializableDictionary.cs" /> </ItemGroup> <ItemGroup> <None Include="app.config" /> <None Include="packages.config" /> </ItemGroup> <ItemGroup> <Content Include="Coda Logo - Image only.ico" /> </ItemGroup> <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" /> <Import Project="..\packages\System.Text.Json.6.0.6\build\System.Text.Json.targets" Condition="Exists('..\packages\System.Text.Json.6.0.6\build\System.Text.Json.targets')" /> <Target Name="EnsureNuGetPackageBuildImports" BeforeTargets="PrepareForBuild"> <PropertyGroup> <ErrorText>This project references NuGet package(s) that are missing on this computer. Use NuGet Package Restore to download them. For more information, see http://go.microsoft.com/fwlink/?LinkID=322105. The missing file is {0}.</ErrorText> </PropertyGroup> <Error Condition="!Exists('..\packages\System.Text.Json.6.0.6\build\System.Text.Json.targets')" Text="$([System.String]::Format('$(ErrorText)', '..\packages\System.Text.Json.6.0.6\build\System.Text.Json.targets'))" /> </Target> </Project>
NUSPEC配置文件
<?xml version="1.0"?> <package xmlns="http://schemas.microsoft.com/packaging/2010/07/nuspec.xsd"> <metadata> <id>$id$</id> <version>$version$</version> <title>$title$</title> <authors>$author$</authors> <owners>$author$</owners> <licenseUrl>https://licenses.nuget.org/CATOSL-1.1</licenseUrl> <projectUrl>https://github.com/info-tpr/CodaEA</projectUrl> <iconUrl>https://www.codaea.io/images/CodaEA.png</iconUrl> <requireLicenseAcceptance>false</requireLicenseAcceptance> <description>$description$</description> <releaseNotes>Summary of changes made in this release of the package.</releaseNotes> <copyright>Copyright 2022, The Parallel Revolution LLC, All Rights Reserved</copyright> <tags>error code analysis</tags> </metadata> </package>
完整错误输出
nuget : The default XML namespace of the project must be the MSBuild XML namespace. If the project is authored in the MSBuild 2003 format, please add xmlns="http://schemas.microsoft.com/developer/msbuild/2003" to the <Project> element. If the project has been authored in the old 1.0 or 1.2 format, please convert it to MSBuild 2003 format. E:\Data\dotNetDev\codaea\CodaRESTServer\packages\System.Text.Json.6.0.6\build\System.Text.Json.targets At line:1 char:1 + nuget pack + ~~~~~~~~~~ + CategoryInfo : NotSpecified: (The default XML...xt.Json.targets:String) [], RemoteException + FullyQualifiedErrorId : NativeCommandError
错误原因分析
从错误信息的最后一行可以明确看出,问题并非出在项目自身的CSPROJ文件,而是依赖包System.Text.Json.6.0.6的System.Text.Json.targets文件。旧版本的NuGet CLI(v5.x及更早)无法兼容.NET Core/.NET 5+风格的targets文件命名空间,这类文件默认使用新的MSBuild命名空间,旧版NuGet CLI识别时会抛出错误。
解决方法
方法1:更新NuGet CLI至最新版本
下载并安装最新版NuGet CLI,重新执行nuget pack命令。新版本已修复该兼容性问题,能正确处理不同格式的targets文件。
方法2:修改依赖包的targets文件
若暂时无法更新NuGet CLI,可手动修改..\packages\System.Text.Json.6.0.6\build\System.Text.Json.targets文件:
- 打开该文件,找到顶部的
<Project>标签。 - 添加MSBuild 2003命名空间属性:
xmlns="http://schemas.microsoft.com/developer/msbuild/2003"。
修改后的开头示例:
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
保存文件后重新执行nuget pack即可。
方法3:使用MSBuild命令替代nuget pack
放弃直接使用nuget pack,改用MSBuild命令打包,兼容性更好:
msbuild /t:pack /p:Configuration=Release
内容的提问来源于stack exchange,提问作者Jay Imerman
相关产品推荐
相关产品推荐

