Visual Studio 2019跨多项目条件编译符号配置及Directory.Build.props失效解决

你遇到的问题是直接赋值<DefineConstants>会覆盖项目本身已有的编译符号（比如DEBUG、RELEASE），导致自定义符号无法和默认符号共存，且没有限定仅在DEBUG配置下生效。按以下方法修改Directory.Build.props即可实现需求：

正确的配置内容 #

将你的Directory.Build.props替换为以下代码，确保自定义符号追加到现有符号中，且仅在DEBUG构建时生效：

<Project>
  <!-- 仅针对DEBUG配置添加自定义符号 -->
  <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
    <!-- 使用$(DefineConstants);符号名的方式追加，避免覆盖原有符号 -->
    <DefineConstants>$(DefineConstants);DbgCountRecordsRead</DefineConstants>
  </PropertyGroup>
</Project>

关键说明 #

• 追加而非覆盖：用$(DefineConstants);DbgCountRecordsRead代替直接赋值，这样会把自定义符号添加到项目已有的编译符号列表中，保留DEBUG等默认符号。
• 限定DEBUG配置：通过Condition="'$(Configuration)' == 'Debug'"确保符号只在DEBUG构建时生效，符合你“结合DEBUG守卫避免代码进入RELEASE构建”的需求。

生效步骤 #

1. 将修改后的Directory.Build.props放在解决方案根目录（或Git仓库根目录，确保所有需要共享符号的项目都在该目录或子目录下）。
2. 重启Visual Studio（VS2019/2022存在缓存问题，必须重启才能加载新的Directory.Build.props配置）。
3. 重新编译解决方案，此时DbgCountRecordsRead符号会自动应用到所有子项目的DEBUG构建中。

验证方法 #

在项目代码中保留你原有的条件编译代码，编译DEBUG版本时，代码块会正常生效；编译RELEASE版本时，该代码块会被忽略：

#if DEBUG && DbgCountRecordsRead
// 项目1诊断代码
#endif

#if DEBUG && DbgCountRecordsRead
// 项目2展示代码
#endif

额外注意事项 #

• 如果部分项目不需要该符号，可以在项目的.csproj文件中单独覆盖，或者在Directory.Build.props中添加排除条件（比如通过Condition指定不包含特定项目）。
• 若要添加多个共享符号，直接用分号分隔：<DefineConstants>$(DefineConstants);Symbol1;Symbol2</DefineConstants>

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