含Git子模块的C#多项目构建CS0006错误解决咨询

你的Git子模块项目结构如下：

ProjA/
├─ ProjB/          # Git子模块
│  └─ ProjC/       # ProjB嵌套的Git子模块
└─ ProjC/          # ProjA独立的Git子模块

ProjA的csproj引用了同级的ProjB和ProjC，但ProjB的csproj里用..\ProjC的相对路径，会指向ProjB自身嵌套的ProjC，而非你期望的ProjA同级的ProjC。这导致MSBuild构建时尝试查找ProjB/ProjC的输出dll，最终抛出CS0006找不到元数据文件的错误。

方案1：调整ProjB的项目引用路径（推荐） #

修改ProjB的csproj文件，将ProjC的引用路径改为从ProjB出发，往上两级指向ProjA同级的ProjC：

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <!-- 替换原路径，指向ProjA同级的ProjC -->
    <ProjectReference Include="..\..\ProjC\ProjC.csproj" />
  </ItemGroup>

</Project>

这样ProjB和ProjA会统一引用同一个ProjC子模块，构建时复用同一输出文件，避免路径冲突。

方案2：移除ProjB嵌套的ProjC子模块（若无需保留） #

如果本来就不需要ProjB自己嵌套的ProjC，直接清理该子模块：

1. 进入ProjB目录，执行Git命令移除子模块：

git submodule deinit -f ProjC
git rm -f ProjC

2. 确保ProjB的csproj引用路径已调整为方案1中的路径。
3. 提交ProjB的变更到其仓库，再更新ProjA中的ProjB子模块。

方案3：用Directory.Build.props统一管理路径（进阶） #

若项目结构可能变动，在ProjA根目录创建Directory.Build.props文件，定义ProjC的全局路径变量：

<Project>
  <PropertyGroup>
    <!-- 定义ProjC的根路径，基于当前文件所在目录 -->
    <ProjCRoot>$(MSBuildThisFileDirectory)ProjC</ProjCRoot>
  </PropertyGroup>
</Project>

然后在ProjA和ProjB的csproj中使用该变量引用ProjC：
ProjA的csproj修改：

<ProjectReference Include="$(ProjCRoot)\ProjC.csproj" />

ProjB的csproj修改：

<ProjectReference Include="$(ProjCRoot)\ProjC.csproj" />

这种方式能统一管理路径，适配复杂项目结构的变动。

1. 删除所有项目的bin和obj目录，清理旧构建输出。
2. 打开ProjA的解决方案，执行重建解决方案。
3. 单独打开ProjB项目执行构建，确认无错误。

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