重写 ToolsVersion 设置

可使用三种方式之一来更改项目和解决方案的工具集：

1. 在从命令行生成项目或解决方案时，使用 /ToolsVersion 开关（或简称为 /tv）

2. 通过设置 MSBuild 任务上的 ToolsVersion 参数

3. 通过设置解决方案中某个项目上的 $(ProjectToolsVersion) 属性 这可使您使用不同于其他项目的工具集版本的解决方法生成项目。

在命令行生成上重写项目和解决方案的 ToolsVersion 设置

虽然 Visual Studio 项目通常使用在项目文件中指定的 ToolsVersion 生成，但也可以使用命令行上的 /ToolsVersion （或 /tv）开关来重写该值，并用不同的工具集来生成所有项目及其项目到项目依赖项。 例如：

msbuild.exe someproj.proj /tv:12.0 /p:Configuration=Debug

在此示例中，所有项目均使用 ToolsVersion 12.0 生成。（但请参见本主题后面的“优先级顺序”一节。）

在命令行中使用 /tv 开关时，可以选择在个别项目中使用 $(ProjectToolsVersion) 属性，以使用与解决方案中的其他项目不同的 ToolsVersion 值来生成这些项目。

使用 MSBuild 任务的 ToolsVersion 参数重写 ToolsVersion 设置

MSBuild 任务是一个项目生成另一个项目的主要方式。 为了使 MSBuild 任务能够使用与项目中指定的值不同的 ToolsVersion 来生成项目，它提供了名为 ToolsVersion 的可选任务参数。 以下示例演示如何使用此参数：

1. 创建一个文件，命名为 projectA.proj，并要包含以下代码：

   <Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003"
   ToolsVersion="12.0">
   
       <Target Name="go" > 
           <Message Text="projectA.proj" />
           <Message Text="MSBuildToolsVersion: $(MSBuildToolsVersion)" />
           <Message Text="MSBuildToolsPath:    $(MSBuildToolsPath)" />
   
           <MSBuild Projects="projectB.proj"
               ToolsVersion="2.0"
               Targets="go" />
       </Target>
   </Project>
   

2. 创建另一个文件，命名为 projectB.proj，且应包含以下代码：

   <Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003"
   ToolsVersion="12.0">
   
       <Target Name="go">
           <Message Text="projectB.proj" />
           <Message Text="MSBuildToolsVersion: $(MSBuildToolsVersion)" />
           <Message Text="MSBuildToolsPath:    $(MSBuildToolsPath)" />
       </Target>
   </Project>
   

3. 在命令提示符处输入以下命令：

   msbuild projectA.proj /t:go /toolsversion:3.5
   

4. 将显示以下输出。 针对 projectA，命令行上的 /toolsversion:3.5 设置将 Project 标记中的 ToolsVersion=12.0 设置进行了重写。

   ProjectB 由 projectA 中的任务调用。 该任务具有 ToolsVersion=2.0，重写了 projectB 的其他 ToolsVersion 设置。

   Output:
     projectA.proj
     MSBuildToolsVersion: 3.5
     MSBuildToolsPath:    C:\Windows\Microsoft.NET\Framework\v3.5
   
     projectB.proj
     MSBuildToolsVersion: 2.0
     MSBuildToolsPath:    C:\Windows\Microsoft.NET\Framework\v2.0.50727
   

优先级顺序

用于决定 ToolsVersion 的优先级顺序从高到低是：

1. 用于生成项目的 MSBuild 任务的 ToolsVersion 特性（如果有的话）。

2. msbuild.exe 命令中使用的（如果有的话）/toolsversion（或 /tv）开关。

3. 如果设置了环境变量 MSBUILDTREATALLTOOLSVERSIONSASCURRENT，则请使用当前的 ToolsVersion。

4. 如果设置了环境变量 MSBUILDTREATHIGHERTOOLSVERSIONASCURRENT，并且在项目文件中定义的 ToolsVersion 比当前的 ToolsVersion大，则使用当前的 ToolsVersion。

5. 如果设置了环境变量 MSBUILDLEGACYDEFAULTTOOLSVERSION，或如果未设置 ToolsVersion，则可使用以下步骤：

   1. 项目文件的项目元素的 ToolsVersion 特性。 如果此属性不存在，则假定是当前版本。

   2. MSBuild.exe. 配置文件中的默认工具版本。

   3. 注册表中的默认工具版本。 有关详细信息，请参阅 标准和自定义工具集配置。

6. 如果未设置环境变量 MSBUILDLEGACYDEFAULTTOOLSVERSION，则可使用以下步骤：

   1. 如果将环境变量 MSBUILDDEFAULTTOOLSVERSION 设置为现有的 ToolsVersion，则可使用。

   2. 如果 DefaultOverrideToolsVersion 以 MSBuild.exe.config 的形式设置，便可使用。

   3. 如果在注册表中设置了 DefaultOverrideToolsVersion，则使用它。

   4. 否则，使用当前 ToolsVersion。

请参见

概念

MSBuild 工具集 (ToolsVersion)

标准和自定义工具集配置

其他资源

MSBuild 多定向概述

MSBuild 概念