Mac环境下CMake导入vcpkg安装的azure-storage-blobs-cpp库失败求助

核心问题原因 #

CMake无法识别vcpkg安装的库，本质是没有正确关联vcpkg的toolchain文件，或者CMakeLists.txt里的库目标引用错误。

步骤1：确认vcpkg toolchain文件路径 #

Mac上vcpkg的toolchain文件位置取决于安装方式：

• 手动克隆vcpkg仓库：~/vcpkg/scripts/buildsystems/vcpkg.cmake
• Homebrew安装（Intel芯片）：/usr/local/share/vcpkg/scripts/buildsystems/vcpkg.cmake
• Homebrew安装（Apple Silicon）：/opt/homebrew/share/vcpkg/scripts/buildsystems/vcpkg.cmake

你也可以执行vcpkg integrate install命令，输出里会直接给出toolchain文件的正确路径。

步骤2：修正CMakeLists.txt内容 #

vcpkg为Azure存储库提供的CMake目标是Azure::azure-storage-blobs，而非直接引用azure-storage-blobs-cpp，正确的示例代码如下：

cmake_minimum_required(VERSION 3.16)
project(azure_blob_demo)

# 添加你的可执行文件
add_executable(${PROJECT_NAME} main.cpp)

# 查找Azure Blobs库配置
find_package(AzureStorageBlobs CONFIG REQUIRED)

# 将库链接到目标程序
target_link_libraries(${PROJECT_NAME} PRIVATE Azure::azure-storage-blobs)

# Azure库要求C++17及以上标准
target_compile_features(${PROJECT_NAME} PRIVATE cxx_std_17)

步骤3：正确执行CMake命令 #

不要直接运行cmake CMakeLists.txt，必须指定toolchain文件，同时注意Apple Silicon芯片需要匹配对应的triplet：

• Intel Mac：

cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=~/vcpkg/scripts/buildsystems/vcpkg.cmake

• Apple Silicon Mac（安装时指定了arm64-osx triplet）：

cmake -S . -B build -DCMAKE_TOOLCHAIN_FILE=~/vcpkg/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=arm64-osx

额外排查点 #

1. 确认库安装成功：重新执行vcpkg install azure-storage-blobs-cpp，检查输出是否有类似Installing package azure-storage-blobs-cpp:x64-osx/xxx... done的完成提示。
2. 检查配置文件存在性：进入vcpkg的installed目录（如~/vcpkg/installed/arm64-osx/share/azure-storage-blobs），确认存在AzureStorageBlobsConfig.cmake文件。
3. Homebrew安装的vcpkg：务必先执行vcpkg integrate install，让CMake能识别vcpkg管理的包。

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