Visual Studio 2019切换Debug到Release配置时#include头文件无法找到问题

我在使用Visual Studio 2019进行C语言开发时，C编译器在Debug配置模式下可正常识别查找#include引入的头文件，但将配置切换为Release模式后，编译器无法找到相同的头文件，进而抛出编译错误。

Visual Studio 中 Debug 和 Release 是两套完全独立的项目配置体系，所有编译相关参数默认不会自动同步，90%以上的此类问题都是因为仅在 Debug 配置中添加了头文件所在的包含目录，Release 配置没有同步配置导致的。

• 右键点击解决方案资源管理器中的项目名称，选择「属性」打开项目配置窗口
• 先将窗口顶部的「配置」下拉框切换为 Release，「平台」选择和 Debug 配置一致的架构（通常为 x86 或 x64）
• 依次展开左侧菜单：「配置属性」→「C/C++」→「常规」
• 查看「附加包含目录」项的配置，对比 Debug 配置下的同名配置项，把缺失的头文件所在路径补全到 Release 配置中即可。如果要避免后续多配置不同步的问题，可以在编辑包含目录时选择「所有配置」选项统一配置，也可以使用 VS 内置宏写通用路径，比如 $(ProjectDir)\include 代表项目根目录下的include文件夹。

如果补全包含目录后问题仍存在，可以排查以下场景：

• 检查头文件引用是否通过条件编译包裹，比如被 #ifdef _DEBUG / #endif 块包裹的头文件仅会在 Debug 模式下被引入，属于业务必要依赖的头文件需要移除外层的条件编译限制
• 如果你使用相对路径引用头文件，检查 Release 模式的生成输出目录是否和 Debug 不同导致相对路径寻址失效，推荐统一使用基于项目内置宏的路径写法
• 检查依赖的第三方库是否区分 Debug/Release 版本的头文件目录，确保 Release 配置关联的是对应 Release 版本库的头文件路径

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