Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion docs/core/tools/dotnet-build.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ title: dotnet build command
description: The dotnet build command builds a project and all of its dependencies.
ms.date: 09/24/2025
---

# dotnet build

**This article applies to:** ✔️ .NET 6 SDK and later versions
Expand All @@ -22,6 +23,7 @@ dotnet build [<PROJECT>|<SOLUTION>|<FILE>] [-a|--arch <ARCHITECTURE>]
[--no-self-contained] [-o|--output <OUTPUT_DIRECTORY>] [--os <OS>]
[-p|--property:<PROPERTYNAME>=<VALUE>] [-r|--runtime <RUNTIME_IDENTIFIER>]
[--sc|--self-contained] [--source <SOURCE>]
[-t|--target <TARGET>]
[--tl:[auto|on|off]] [ --ucr|--use-current-runtime]
[-v|--verbosity <LEVEL>] [--version-suffix <VERSION_SUFFIX>]

Expand Down Expand Up @@ -155,6 +157,16 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev

The URI of the NuGet package source to use during the restore operation.

- **`-t|--target <TARGET>`**

Specifies one or more MSBuild targets to run during the build, instead of the default target. Multiple targets can be specified by separating them with a semicolon or by repeating the option. Corresponds to the MSBuild `-target` option. Common targets include `Build` (default), `Clean`, and `Rebuild`.. For more information about targets, see [MSBuild Targets](/visualstudio/msbuild/msbuild-targets).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Specifies one or more MSBuild targets to run during the build, instead of the default target. Multiple targets can be specified by separating them with a semicolon or by repeating the option. Corresponds to the MSBuild `-target` option. Common targets include `Build` (default), `Clean`, and `Rebuild`.. For more information about targets, see [MSBuild Targets](/visualstudio/msbuild/msbuild-targets).
Specifies one or more MSBuild targets to run during the build, instead of the default target. Multiple targets can be specified by separating them with a semicolon or by repeating the option. Corresponds to the MSBuild `-target` option. Common targets include `Build` (default), `Clean`, and `Rebuild`. For more information about targets, see [MSBuild Targets](/visualstudio/msbuild/msbuild-targets).


```dotnetcli
dotnet build -t:Clean
dotnet build -t:Rebuild
dotnet build -t:Clean;Build
Comment on lines +165 to +167
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
dotnet build -t:Clean
dotnet build -t:Rebuild
dotnet build -t:Clean;Build
dotnet build -t Clean
dotnet build -t Rebuild
dotnet build -t Clean;Build

As given in the synopsis above. When the : is needed then L26 should be

-[-t|--target <TARGET>]
+[-t|--target:<TARGET>]

```

- [!INCLUDE [tl](includes/cli-tl.md)]

- [!INCLUDE [use-current-runtime](includes/cli-use-current-runtime.md)]
Expand Down Expand Up @@ -203,6 +215,12 @@ Running `dotnet build` is equivalent to running `dotnet msbuild -restore`; howev

- Build the project and set version 1.2.3.4 as a build parameter using the `-p` [MSBuild option](#msbuild):

```dotnetcli
```dotnetcli
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: undo

dotnet build -p:Version=1.2.3.4
```

- Run the `Clean` target to remove previous build outputs:

```dotnetcli
dotnet build -t:Clean
Copy link
Copy Markdown
Member

@gfoidl gfoidl May 11, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

```
Loading