如何基于本地/TeamCity环境配置条件化的AdditionalIncludeDirectories？

下面提供几种可行的解决方案，按推荐优先级排序：

方案一：利用TeamCity内置参数自动区分环境 #

TeamCity在构建时会自动注入专属环境变量，无需额外配置，直接在项目文件中通过条件判断区分环境：

1. 打开项目的.vcxproj文件，找到原<AdditionalIncludeDirectories>节点，替换为以下内容：

<Choose>
  <When Condition="'$(teamcity.serverUrl)' != ''">
    <!-- TeamCity构建环境，使用服务器路径 -->
    <PropertyGroup>
      <AdditionalIncludeDirectories>$(OutDir)\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
    </PropertyGroup>
  </When>
  <Otherwise>
    <!-- 本地开发环境，使用本地相对路径 -->
    <PropertyGroup>
      <AdditionalIncludeDirectories>..\..\..\lib_name\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
    </PropertyGroup>
  </Otherwise>
</Choose>

2. 保存文件后，本地构建和TeamCity构建会自动匹配对应路径，无需额外操作。

方案二：自定义环境变量区分环境 #

通过在TeamCity中设置专属环境变量，让MSBuild根据变量值选择路径：

1. 在TeamCity的构建配置中，添加环境变量类型的构建参数：BUILD_ENV=TeamCity。
2. 编辑项目的.vcxproj文件，修改Include路径配置：

<PropertyGroup Condition="'$(BUILD_ENV)' == 'TeamCity'">
  <AdditionalIncludeDirectories>$(OutDir)\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
</PropertyGroup>
<PropertyGroup Condition="'$(BUILD_ENV)' != 'TeamCity' Or '$(BUILD_ENV)' == ''">
  <AdditionalIncludeDirectories>..\..\..\lib_name\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
</PropertyGroup>

3. 本地构建时无需设置该环境变量，会自动使用本地路径；若需要强制本地使用服务器路径，可手动在系统环境变量中添加BUILD_ENV=TeamCity。

方案三：通过MSBuild命令行参数传递路径 #

在TeamCity的构建命令中直接指定路径参数，覆盖本地配置：

1. 在TeamCity的MSBuild构建步骤中，添加命令行参数：/p:ServerIncludePath=$(OutDir)\include。
2. 编辑项目的.vcxproj文件，调整Include路径：

<AdditionalIncludeDirectories Condition="'$(ServerIncludePath)' != ''">$(ServerIncludePath);%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
<AdditionalIncludeDirectories Condition="'$(ServerIncludePath)' == ''">..\..\..\lib_name\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

3. 本地构建时不传递该参数，自动使用本地路径；TeamCity构建时通过参数注入服务器路径。

方案选择建议 #

• 优先选方案一：无需额外配置TeamCity参数，依赖TeamCity内置变量自动区分，最省心。
• 若担心TeamCity内置变量变动，选方案二：自定义环境变量兼容性更强，适用于多种CI/CD平台。
• 若偏好通过命令行控制构建参数，选方案三：参数传递更直观，便于灵活调整路径。

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