ASP.NET Core 2.0项目在TFS2015构建服务器报XML命名空间错误求助

刚碰到这个问题的时候我也一头雾水——明明在VS2017里跑的好好的项目，放到TFS2015构建服务器上就报命名空间错误。其实核心原因是TFS2015默认的MSBuild版本不兼容ASP.NET Core 2.0的SDK风格项目文件，下面是具体的解决步骤：

1. 给构建服务器安装.NET Core 2.0 SDK #

TFS2015自带的MSBuild（版本14.0）是为传统.NET Framework项目设计的，完全识别不了ASP.NET Core的新项目格式。你需要在构建服务器上安装官方的.NET Core 2.0 SDK，安装完成后，SDK会自带适配Core项目的专属MSBuild工具。

2. 在TFS构建定义里指定正确的MSBuild路径 #

打开你的TFS构建定义，找到MSBuild构建步骤：

• 找到「MSBuild版本」选项，选择「指定路径」
• 输入.NET Core SDK中MSBuild.dll的路径，默认路径示例：C:\Program Files\dotnet\sdk\2.0.0\MSBuild.dll（注意根据你实际安装的SDK版本号调整路径里的2.0.0）

如果你的构建步骤用的是「Dotnet Core」任务而非传统MSBuild，那更简单：直接选择对应的命令（比如build），并确保任务里指定的SDK版本为2.0.x即可。

3. 检查项目文件格式（可选） #

VS2017创建的ASP.NET Core 2.0项目应该已经是SDK风格了，开头结构大概是这样：

<Project Sdk="Microsoft.NET.Sdk.Web">
  <PropertyGroup>
    <TargetFramework>netcoreapp2.0</TargetFramework>
  </PropertyGroup>
  <!-- 其他项目配置 -->
</Project>

如果你的项目是从旧版本迁移过来的，还保留着传统MSBuild的命名空间（比如xmlns="http://schemas.microsoft.com/developer/msbuild/2003"），建议把项目转换为SDK格式——在VS2017里右键项目→「编辑项目文件」就能直接修改，或者用官方迁移工具转换。

4. 确保构建代理的环境变量配置正确 #

有时候即使安装了SDK，构建代理也找不到对应的工具。这时候需要检查构建代理的PATH环境变量是否包含dotnet的安装路径（比如C:\Program Files\dotnet），这样构建时才能正确调用dotnet命令和对应的MSBuild。

为什么会出现这个错误？ #

TFS2015发布于2015年，而ASP.NET Core 2.0是2017年才推出的，所以TFS2015的默认构建工具链完全不知道新的SDK项目格式。它会把这种简洁的项目文件当成「格式错误的旧版MSBuild项目」，从而抛出要求添加2003命名空间的误导性提示——根本问题其实是工具版本不兼容。

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