使用vcpkg安装Azure Storage C++静态库后遇LNK2019链接错误求助

你遇到的这个未解析外部符号问题，虽然vcpkg号称“安装即忘”，但静态库的配置细节偶尔还是会需要手动确认。结合你使用的是azure-storage-cpp:x64-windows-static 7.0.0和VS2019的环境，我整理了几个最可能的原因和对应解决步骤：

• 确认项目平台与vcpkg安装目标匹配
  你安装的是x64-windows-static，务必确保你的VS项目平台设置为x64（而非默认的x86）：

  1. 右键项目→属性→配置属性→常规→平台，选择x64
  2. 同时检查运行库设置：静态发布版本对应Multi-threaded (/MT)（Release模式）或Multi-threaded Debug (/MTd)（Debug模式），不能使用DLL版本的运行库（比如/MD）

• 验证vcpkg集成是否生效
  有时候VS项目可能没正确关联vcpkg的配置，尝试以下操作：

  1. 打开命令行，进入你的vcpkg安装目录，重新运行vcpkg integrate install
  2. 重启Visual Studio后再打开项目，检查项目属性→VC++目录→库目录，是否包含[你的vcpkg路径]\installed\x64-windows-static\lib，如果没有则手动添加

• 添加静态库专属预处理器宏
  针对Azure Storage C的静态库版本，必须定义AZURE_STORAGE_STATIC宏，否则编译器会默认尝试链接DLL版本的符号：
  右键项目→属性→配置属性→C/C→预处理器→预处理器定义，添加AZURE_STORAGE_STATIC

• 检查并添加必要的依赖库
  Azure Storage C++静态库依赖若干系统库（比如crypt32.lib、winhttp.lib），vcpkg可能未自动添加所有依赖：

  1. 查看vcpkg安装目录下的installed\x64-windows-static\share\azure-storage-cpp文件夹中的usage文件，里面会列出需要手动链接的库
  2. 右键项目→属性→配置属性→链接器→输入→附加依赖项，添加这些依赖库

• 重新安装vcpkg包排除损坏情况
  偶尔包安装可能出现隐性错误，尝试卸载重装：

  vcpkg remove azure-storage-cpp:x64-windows-static
  vcpkg install azure-storage-cpp:x64-windows-static
  

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