2024年3月23日发(作者：)

dotnet msbuild用法

dotnet msbuild 用法详解

什么是 dotnet msbuild

dotnet msbuild 是 Microsoft Build Engine（MSBuild）的一个

跨平台版本，用于构建、发布和部署 .NET 应用程序。它是一个命令

行工具，可以在命令行中使用。

dotnet msbuild 基本用法

以下是一些常见的 dotnet msbuild 命令用法：

• dotnet msbuild：执行默认的 MSBuild 构建，并在当前目录中

查找 .sln 文件进行构建。

• dotnet msbuild .csproj：构建指定的项目文件。

• dotnet msbuild /t:：执行指定的构建目标。目标

可以是项目文件中定义的任何目标，如 Clean、Build、

Publish 等。

dotnet msbuild 参数用法

dotnet msbuild 可以使用一些参数来自定义构建的行为。以下是

一些常用的参数：

• /p:=：设置一个属性的值。可以通过此参

数来自定义构建的行为。例如，/p:Configuration=Release

设置构建配置为 Release。

• /l:：指定一个日志记录器。MSBuild 默认使用

ConsoleLogger，可以通过此参数来指定其他日志记录器。例如，

/l:FileLogger,logfile= 将构建日志记录到指定文件中。

dotnet msbuild 高级用法

使用自定义的属性进行构建

除了使用命令行参数设置属性，还可以在项目文件中设置自定义

属性。然后在构建命令中使用 /p:= 来赋值。

示例：

dotnet msbuild /p:MyCustomProperty=HelloWorld

使用分析器进行性能优化

dotnet msbuild 提供了几种分析器工具，用于帮助识别和优化构

建性能问题。

以下是一些常用的分析器工具：

• BinaryLogger：记录详细的构建过程，并生成二进制日志文件。

• MSBuildStructuredLog：将构建过程转换为结构化日志，用于

分析构建性能问题。

• SummaryLogger：生成压缩的构建摘要日志文件，仅包含关键信

息。

使用分析器工具时，需要先安装扩展包。然后在构建命令中指定

相应的分析器。

示例：

dotnet tool install -g

dotnet msbuild /l:BinaryLogger, /flp:LogFile=

总结

本文介绍了 dotnet msbuild 的基本用法和常用参数，并提供了

一些高级用法的示例。使用 dotnet msbuild 可以方便地构建、发布

和部署 .NET 应用程序，同时还可以通过自定义属性和分析器工具来

优化构建性能。希望本文能帮助读者更好地理解和使用 dotnet

msbuild。