Visual Studio：命令行相同的两个小型项目，其一无法找到头文件

问题概述 #

• 解决方案包含两个单源文件项目，代码完全相同，均包含#include <mosquitto.h>
• 其中一个项目编译正常（下称Good项目），另一个（下称Bad项目）编译失败，报错fatal error C1083: Cannot open include file: 'mosquitto.h': No such file or directory
• 两个项目均未启用预编译头，但编译命令中出现/Fp选项，不确定是否影响
• 提供的编译命令为Release x64配置，但编译失败的是Debug x64配置

关键分析 #

1. 配置不匹配是核心原因：
   失败的编译日志明确显示是Debug x64配置，但提供的两个项目编译命令都是Release x64的，且都包含了/I"C:\Program Files\mosquitto2.0.14\devel"头文件路径。这说明Bad项目的Debug x64配置大概率没有添加该头文件包含路径。
2. /Fp选项的影响：
   /Fp是指定预编译头文件的输出路径，虽然项目未启用预编译头，但这个选项本身不会直接导致头文件找不到，不过如果预编译头相关配置混乱，可能间接引发问题，但优先级低于包含路径的问题。

解决步骤 #

1. 检查并修复Bad项目的Debug配置 #

• 右键Bad项目 → 属性 → 配置属性 → C/C++ → 常规 → 附加包含目录
• 确认是否添加了C:\Program Files\mosquitto2.0.14\devel路径，若未添加则手动添加
• 确保配置选择的是Debug x64（而非Release）

2. 验证配置生效 #

重新生成Bad项目的Debug配置，查看编译命令中是否包含/I"C:\Program Files\mosquitto2.0.14\devel"，若存在则说明配置已生效。

3. 清理预编译头相关冗余配置（可选） #

由于两个项目都未启用预编译头，可彻底移除/Fp选项避免潜在冲突：

• 右键项目 → 属性 → 配置属性 → C/C++ → 预编译头 → 预编译头选择“不使用预编译头”
• 确保该设置在所有配置（Release/Debug、x86/x64）中均已应用

附原始信息 #

Release x64编译命令 #

// Good项目
/permissive- /ifcOutput "x64\Release\" /GS /GL /W3 /Gy /Zc:wchar_t /I"C:\Program Files\mosquitto2.0.14\devel" /Zi /Gm- /Od /sdl /Fd"x64\Release\vc143.pdb" /Zc:inline /fp:precise /D "NDEBUG" /D "_CONSOLE" /D "_UNICODE" /D "UNICODE" /errorReport:prompt /WX- /Zc:forScope /Gd /Oi /MD /FC /Fa"x64\Release\" /EHsc /nologo /Fo"x64\Release\" /Fp"x64\Release\Good.pch" /diagnostics:column 

// Bad项目
/permissive- /ifcOutput "x64\Release\" /GS /GL /W3 /Gy /Zc:wchar_t /I"C:\Program Files\mosquitto2.0.14\devel" /Zi /Gm- /O2 /sdl /Fd"x64\Release\vc143.pdb" /Zc:inline /fp:precise /D "NDEBUG" /D "_CONSOLE" /D "_UNICODE" /D "UNICODE" /errorReport:prompt /WX- /Zc:forScope /Gd /Oi /MD /FC /Fa"x64\Release\" /EHsc /nologo /Fo"x64\Release\" /Fp"x64\Release\Bad.pch" /diagnostics:column 

Debug x64编译失败日志 #

Build started...
1>------ Build started: Project: Bad, Configuration: Debug x64 ------
1>Bad.cpp
1>T:\MyFirm\dev\MinorProjects\Bad\Bad.cpp(55,10): fatal error C1083: Cannot open include file: 'mosquitto.h': No such file or directory
1>Done building project "Bad.vcxproj" -- FAILED.
========== Build: 0 succeeded, 1 failed, 0 up-to-date, 0 skipped ==========

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