如何从Git子模块的子目录引用共享的Directory.Build.props/targets文件？

核心实现思路 #

借助MSBuild的配置导入机制，在各父仓库的根目录配置文件中，导入子模块内的通用MSBuild配置，从而让共享配置作用于父仓库的所有项目。

具体操作步骤 #

1. 在共享子模块中创建通用配置文件 #

在子模块根目录创建SharedDirectory.Build.props（自定义命名避免与父仓库默认文件冲突），写入通用配置内容，示例如下：

<Project>
  <!-- 通用属性配置 -->
  <PropertyGroup>
    <LangVersion>latest</LangVersion>
    <WarningLevel>4</WarningLevel>
    <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
  </PropertyGroup>

  <!-- 自定义共享目标（按需添加） -->
  <Target Name="SharedPreBuildCheck" BeforeTargets="PreBuildEvent">
    <Message Text="执行共享预构建检查" Importance="high" />
  </Target>
</Project>

2. 在父仓库中导入共享配置 #

在每个父仓库的根目录创建或修改Directory.Build.props，添加导入语句，路径指向子模块内的共享配置文件。假设子模块目录名为SharedLibSubmodule，代码如下：

<Project>
  <!-- 导入子模块中的共享配置 -->
  <Import Project="$(MSBuildThisFileDirectory)SharedLibSubmodule\SharedDirectory.Build.props" />

  <!-- 父仓库专属配置（可选，可覆盖共享配置） -->
  <PropertyGroup>
    <!-- 示例：仅当前仓库关闭警告转错误 -->
    <!-- <TreatWarningsAsErrors>false</TreatWarningsAsErrors> -->
  </PropertyGroup>
</Project>

• 重点使用*$(MSBuildThisFileDirectory)*这个MSBuild内置属性，它代表当前Directory.Build.props的所在目录，避免硬编码路径，保证跨环境、跨仓库的兼容性。

3. 验证配置生效 #

完成配置后，打开父仓库的解决方案执行构建：

• 可以查看项目属性页，确认共享属性已应用；
• 若添加了自定义目标，可在构建日志中查看对应的输出信息，验证目标是否执行。

补充说明 #

• 如果需要共享构建目标逻辑（如自定义打包、代码检查步骤），可以创建SharedDirectory.Build.targets文件，在父仓库的Directory.Build.targets中导入，原理与props文件完全一致；
• 确保父仓库已正确初始化并更新子模块（执行git submodule update --init），否则会因找不到子模块文件导致导入失败；
• MSBuild会自动递归加载根目录的Directory.Build.props，父仓库内的所有子项目都会自动应用共享配置，无需逐个项目配置。

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