MSBuild .NET Core 3.1项目csproj设置PublishDir不生效问题咨询

默认PublishDir路径来源 #

SDK风格csproj（即.NET Core/.NET 5+使用的新版csproj格式）的默认发布路径由Microsoft.NET.Sdk内置的目标逻辑定义，拼接规则为：
基础路径取自默认输出路径$(OutputPath)，再拼接目标框架标识$(TargetFramework)、运行时标识符$(RuntimeIdentifier)，最后加上publish后缀，默认结构为bin/$(Configuration)/$(TargetFramework)/$(RuntimeIdentifier)/publish/。你看到的app.publish后缀是单文件发布、自包含发布等特殊场景下的额外调整。

配置不生效的原因及正确配置方式 #

直接在csproj开头设置PublishDir不生效的核心原因是属性导入顺序问题：Microsoft.NET.Sdk的默认属性导入会覆盖早于它加载的自定义属性配置。

正确配置方法 #

将PublishDir的属性组写在csproj文件的末尾位置，也就是所有原生导入节点的后面，即可避开被默认配置覆盖的问题，支持按Condition区分不同场景的配置：

<Project Sdk="Microsoft.NET.Sdk">
  <!-- 原有项目配置，包括目标框架、输出类型、引用等内容 -->
  <PropertyGroup>
    <!-- 可按需要添加Condition规则区分配置 -->
    <PublishDir Condition="'$(Configuration)' == 'Release'">..\test\release\path\</PublishDir>
    <PublishDir Condition="'$(Configuration)' == 'Debug'">..\test\debug\path\</PublishDir>
    <!-- 通用配置可去掉Condition -->
    <!-- <PublishDir>..\test\path\</PublishDir> -->
  </PropertyGroup>
</Project>

配置注意事项 #

• 路径末尾必须加斜杠（\或/均可，MSBuild自动兼容跨平台场景），否则MSBuild会将路径最后一段识别为文件名前缀，导致生成的路径异常。
• 不需要在PrepareForPublish目标执行后设置属性，只要属性在csproj末尾配置，会在SDK内置的_ComputePublishDir目标（负责最终计算发布路径，运行于PrepareForPublish之前）执行前被正确读取。
• 不要和PublishUrl属性混用，不同发布场景下两个属性的优先级有差异，统一使用PublishDir即可。
• 如果使用全局属性配置文件Directory.Build.props，不要在该文件内配置PublishDir，该文件加载时机早于SDK导入，配置会被覆盖，需要写到Directory.Build.targets中才会生效。
• 命令行通过/p:PublishDir=传入的参数优先级最高，会覆盖csproj中的同名配置。

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