编译azure-iot-sdk-c遥测示例已装Vcpkg仍提示包缺失问题咨询

按照编译过程中积累的实际排查经验，对应报错可以按以下顺序逐一定位解决：

• Vcpkg全局集成配置未生效
  只完成Vcpkg本体安装，不会自动打通和Visual Studio的依赖关联，需要手动执行集成命令vcpkg integrate install，看到命令行输出集成成功的提示后，完全关闭并重启Visual Studio，让工程重新加载自动关联的Vcpkg头文件、库文件查找路径
• 安装的依赖包架构和项目目标架构不匹配
  报错提示缺失的iothub.h头文件，需要确认已安装的azure-iot-sdk-c包架构和当前项目编译目标完全一致：
  • 如果项目选择x64 Debug配置编译，仅安装x86版本的依赖包就会触发找不到头文件的问题
  • 依赖安装命令需要匹配目标架构的三元组，x64 Windows环境对应执行vcpkg install azure-iot-sdk-c[public-preview,use_prov_client]:x64-windows
  • 安装完成后可以直接到Vcpkg安装目录的installed/<对应架构目录>/include/azureiot路径下，手动确认iothub.h文件真实存在，排除包安装不完整的问题
• 工程内的Vcpkg关联配置失效
  定位到报错行对应的vcxproj文件位置，检查其中关联的Vcpkg清单文件路径、目标三元组配置，确认没有因为仓库目录移动、本地路径调整出现路径失效的问题；不建议通过手动拷贝头文件到项目目录的方式绕过报错，这类操作会在后续链接阶段触发更多找不到依赖库的连锁错误
• 旧编译缓存干扰路径识别
  完成以上配置调整后，删除项目目录下的.vs隐藏缓存文件夹、对应架构的中间编译输出目录，再重新加载工程开始编译，避免旧缓存保留了错误的依赖查找路径，导致配置生效后依然报错

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