工具包和构建

在此页面，您可以配置 Rider 的构建过程。

工具集


Mono 可执行文件路径	如果您希望在 macOS 上构建 .NET 项目，则需要指定 Mono 可执行文件。
.NET CLI 可执行文件路径	.NET CLI 工具可执行文件的路径会自动检测，但如果您的设置需要，您可以指定自定义安装路径。
MSBuild 版本	使用此选择器，您可以选择用于构建解决方案的 MSBuild.exe 版本。您可以选择自动检测到的 MSBuild 版本之一，或者指定非标准位置的自定义 MSBuild 可执行文件路径。
MSBuild 全局属性	在此字段中，您可以指定用于 ReSharper Build 的全局 MSBuild 属性。
如果需要，自动下载 .NET SDK	启用后，JetBrains Rider 会自动检测并下载所需的 .NET SDK 版本，如果该版本缺失或与项目不兼容，可确保项目设置与构建过程顺利进行。如需在离线环境中使用，或手动管理 SDK 或安装自定义 SDK，请禁用此选项。

构建


使用 ReSharper Build	如果选中此复选框，JetBrains Rider 将通过 ReSharper Build 优化构建过程，该过程会跟踪解决方案中的更改，仅重新构建已修改的项目和必要的依赖项。如果未选中该复选框，JetBrains Rider 会将整个解决方案的构建委托给 MSBuild.exe 。如果您的解决方案包含非 MSBuild 项目或使用了自定义构建步骤的项目，可能需要禁用此选项。如果您的解决方案包含非 MSBuild 项目或具有自定义构建步骤的项目，您可能需要禁用此选项。
加载解决方案后运行构建	此不言自明的选项将独立于所选的构建管理首选项应用。
构建前还原 NuGet 软件包	选中此复选框时，JetBrains Rider 将为当前解决方案中的所有项目还原 NuGet 包。请注意，此选项要求您的计算机上安装 .NET Framework 4.5 或更高版本。仅当构建、执行、部署 \| NuGet 设置页面上的相应选项允许时，Rider 才会还原 NuGet 包。
并行使用最多 X 个进程	使用此选择器，您可以选择在显式调用 ReSharper Build 时使用的并行进程数。
为跳过的项目调用构建前和构建后事件目标	当 JetBrains Rider 使用启发式方法在构建过程中跳过某些项目时，这些项目将被完全跳过，包括所有附加的构建逻辑。使用此复选框始终为所有项目执行预构建和后构建事件。要检查和配置预构建和后构建事件，请在解决方案资源管理器中右键单击项目，选择属性，然后选择构建事件。
为跳过的项目调用 BeforeBuild 和 AfterBuild 目标	当 JetBrains Rider 使用启发式方法在构建过程中跳过某些项目时，这些项目将被完全跳过，包括所有附加的构建逻辑。使用此复选框始终执行 BeforeBuild 和 AfterBuild MSBuild 目标。

设计时构建（解决方案加载）

当您打开一个解决方案时，JetBrains Rider 会在后台启动 MSBuild，以构建每个项目中的文件列表、解析项目引用等。


并行使用最多 X 个进程	在大多数情况下，单进程启动 MSBuild 会带来最快的解决方案加载时间，但有时（主要是在大型解决方案中）多进程可以加快解决方案加载速度。因此，如果在打开解决方案后，您看到“等待解决方案同步”状态持续时间过长，可以尝试在此选择器中设置多个进程。
MSBuild 解决方案加载目标	如果您的解决方案使用通过 MSBuild 目标定义的一些非标准组件，JetBrains Rider 可能无法加载这些组件。一个典型的症状是某些文件中未解析的（红色）代码，但解决方案构建时没有错误。在这种情况下，请在此字段中以逗号分隔列出这些目标的名称。
根据依赖关系排序项目加载

并行使用最多 X 个进程

在大多数情况下，单进程启动 MSBuild 会带来最快的解决方案加载时间，但有时（主要是在大型解决方案中）多进程可以加快解决方案加载速度。

因此，如果在打开解决方案后，您看到“等待解决方案同步”状态持续时间过长，可以尝试在此选择器中设置多个进程。

MSBuild 解决方案加载目标

如果您的解决方案使用通过 MSBuild 目标定义的一些非标准组件，JetBrains Rider 可能无法加载这些组件。一个典型的症状是某些文件中未解析的（红色）代码，但解决方案构建时没有错误。

在这种情况下，请在此字段中以逗号分隔列出这些目标的名称。

根据依赖关系排序项目加载

构建日志记录


将 MSBuild 日志写入输出	选中此复选框时，在其下选择的日志项将显示在构建窗口中。
将 MSBuild 写入日志文件	选中此复选框时，构建输出将保存到日志文件中。使用此复选框下的控件选择详细级别和日志文件保存路径。如果所选的日志目录不存在，则会以红色显示。但是，JetBrains Rider 在首次记录到文件时会创建不存在的路径。请注意，记录到文件不依赖于记录到构建窗口。
将 Visual Studio 形参传递给该构建	如果您选择将解决方案构建委托给 MSBuild（未选择使用 ReSharper Build 选项），JetBrains Rider 默认不会将 `$(VisualStudioVersion)` 和 `$(BuildingInsideVisualStudio)` 属性传递给 MSBuild。如果您的项目中使用了这些属性，请选中此复选框以覆盖默认行为。

将 MSBuild 日志写入输出

选中此复选框时，在其下选择的日志项将显示在构建窗口中。

将 MSBuild 写入日志文件

选中此复选框时，构建输出将保存到日志文件中。使用此复选框下的控件选择详细级别和日志文件保存路径。如果所选的日志目录不存在，则会以红色显示。但是，JetBrains Rider 在首次记录到文件时会创建不存在的路径。

请注意，记录到文件不依赖于记录到构建窗口。

将 Visual Studio 形参传递给该构建

如果您选择将解决方案构建委托给 MSBuild（未选择使用 ReSharper Build 选项），JetBrains Rider 默认不会将 $(VisualStudioVersion) 和 $(BuildingInsideVisualStudio) 属性传递给 MSBuild。

如果您的项目中使用了这些属性，请选中此复选框以覆盖默认行为。

最后修改日期： 2025年 9月 26日