引用其他.NET解决方案下项目时CI构建失败如何快速解决？

快速可行的3种低复杂度解决方案 #

方案1：统一相对路径结构（首推，改造成本最低） #

• 调整本地两个项目的目录层级，保证两个项目的相对路径固定，推荐统一放在同一个根目录下，结构示例：

根目录/
├─ InvoiceManagement/    # 发票处理项目
└─ CommonLib/            # 公共复用项目

• 修改发票项目的项目引用配置，把原来的绝对路径引用改为相对路径引用，csproj文件中配置示例：

<ProjectReference Include="../CommonLib/CommonLib.csproj" />

• CI流水线仅需要新增1步：在构建发票项目前，将公共项目的代码拉取到上述对应的相对路径位置即可，路径逻辑和本地完全一致，不需要额外修改项目配置。

方案2：条件化配置引用路径 #

• 在发票项目根目录新增Directory.Build.props文件，通过环境变量区分本地和CI环境，分别配置对应的公共项目路径，示例配置：

<Project>
  <Choose>
    <!-- 本地开发环境路径配置 -->
    <When Condition="'$(CI)' != 'true'">
      <PropertyGroup>
        <CommonProjectPath>你本地公共项目的绝对路径/CommonLib.csproj</CommonProjectPath>
      </PropertyGroup>
    </When>
    <!-- CI构建环境路径配置 -->
    <When Condition="'$(CI)' == 'true'">
      <PropertyGroup>
        <CommonProjectPath>CI服务器上公共项目的固定路径/CommonLib.csproj</CommonProjectPath>
      </PropertyGroup>
    </When>
  </Choose>
</Project>

• 把发票项目原来的硬编码引用改为变量引用：<ProjectReference Include="$(CommonProjectPath)" />，CI环境自带CI=true的内置环境变量，不需要额外配置即可生效。

方案3：CI预构建公共项目复用dll #

• 在CI流水线中新增前置步骤：先单独拉取公共项目代码构建，将生成的dll拷贝到发票项目的固定相对目录下（例如./libs/）
• 将发票项目的项目引用改为对该目录下dll的引用，使用相对路径即可：<Reference Include="./libs/CommonLib.dll" />
• 该方案不需要改动本地开发逻辑，仅调整CI流程和引用方式即可快速跑通构建。

以上方案的改造成本都远低于封装Nuget包或搭建集中文件服务器，最快1小时内即可完成配置跑通CI流程。

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