针对多环境自动构建C#项目遇CS0006依赖元数据文件缺失问题

问题根源 #

你的脚本在递归调用CoreBuild时，未正确处理项目依赖项的输出路径，导致编译时找不到依赖项的元数据文件（如.dll、.pdb等）；同时原脚本会触发无限递归——BuildAllEnvironments绑定在Build前执行，而BuildSingleEnvironment又调用项目构建，会再次触发BuildAllEnvironments。

修正后的csproj配置 #

替换你原有的脚本为以下内容：

<PropertyGroup>
  <!-- 禁用默认Build目标，避免递归触发 -->
  <DefaultBuildTargets>BuildAllEnvironments</DefaultBuildTargets>
</PropertyGroup>

<ItemGroup>
  <BuildEnvironment Include="Dev" />
  <BuildEnvironment Include="Staging" />
  <BuildEnvironment Include="Prod" />
</ItemGroup>

<Target Name="BuildAllEnvironments">
  <!-- 循环构建每个环境，直接传递输出路径与编译常量 -->
  <MSBuild 
    Projects="$(MSBuildProjectFullPath)" 
    Targets="BuildSingleEnvironment" 
    Properties="BuildEnvironment=%(BuildEnvironment.Identity);OutputPath=$(OutputPath)%(BuildEnvironment.Identity)\;DefineConstants=$(DefineConstants);BUILD_ENV_%(BuildEnvironment.Identity)"
    BuildInParallel="true" />
</Target>

<Target Name="BuildSingleEnvironment" DependsOnTargets="Restore;Build">
  <!-- 依赖Restore和Build目标，自动处理依赖还原与编译流程 -->
</Target>

<!-- 可选：清理时批量删除所有环境的输出目录 -->
<Target Name="CleanAllEnvironments">
  <RemoveDir Directories="$(OutputPath)Dev;$(OutputPath)Staging;$(OutputPath)Prod" />
</Target>

关键改动说明 #

• 禁用默认Build目标：通过<DefaultBuildTargets>指定自定义入口，彻底避免递归问题。
• 直接传递属性：在MSBuild任务中直接传递OutputPath和DefineConstants，确保依赖项也输出到对应环境的子目录，解决元数据文件找不到的问题。
• 绑定依赖目标：BuildSingleEnvironment依赖Restore和Build，确保先还原依赖再执行编译，符合.NET项目构建的标准流程。
• 并行构建：开启BuildInParallel="true"可提升多环境构建的速度。

使用说明 #

在Visual Studio中直接点击构建按钮，项目会自动为Dev、Staging、Prod三个环境分别构建，输出到bin\$(Configuration)\Dev、bin\$(Configuration)\Staging、bin\$(Configuration)\Prod目录下。代码中可通过#if BUILD_ENV_Dev等条件编译指令区分环境逻辑。

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