Mac下C++使用libvips调用pdfload报x86_64未定义符号链接错误

• 最核心的问题是CMake配置找错了依赖包：你当前用pkg-config搜索的是C语言版的vips库，而代码里用的vips::VImage类、pdfload/write_to_file这些方法都属于libvips的C封装层，对应的pkg-config包名是vips-cpp，C版库本身不包含这些C符号，自然会报符号找不到的链接错误。
• 现有CMake配置没有完整传递编译参数：你只给GLib加了CFLAGS_OTHER编译选项，没有给libvips加对应宏定义、编译flag，很容易出现头文件声明和实际链接的库符号不匹配的问题。另外你单独搜GLib是多余的，vips-cpp本身依赖GLib，pkg-config会自动把依赖的编译链接参数带全。
• 测试代码缺少必要初始化：libvips要求所有接口调用前必须执行VIPS_INIT初始化，就算解决了链接问题，原代码运行也会直接崩溃。
• 后续如果链接通过但运行时提示找不到pdfload操作，是因为安装libvips时没装PDF解析依赖poppler，属于运行时依赖缺失，不是链接问题。

1. 替换CMakeLists.txt配置 #

删掉原来冗余的GLib查找逻辑，直接引入vips-cpp依赖，用target级别的配置（不要用全局的include_directories/link_directories，避免污染其他目标），修正后配置如下：

cmake_minimum_required(VERSION 3.19)
project(untitled5)

set(CMAKE_CXX_STANDARD 11)

find_package(PkgConfig REQUIRED)
# 查找C++版本的libvips，自动拉取所有依赖项
pkg_search_module(VIPS_CPP REQUIRED vips-cpp)

add_executable(untitled5 main.cpp)

# 传递头文件路径、编译选项、库路径、链接库
target_include_directories(untitled5 PRIVATE ${VIPS_CPP_INCLUDE_DIRS})
target_compile_options(untitled5 PRIVATE ${VIPS_CPP_CFLAGS_OTHER})
target_link_directories(untitled5 PRIVATE ${VIPS_CPP_LIBRARY_DIRS})
target_link_libraries(untitled5 PRIVATE ${VIPS_CPP_LIBRARIES})

修改完后记得删除CLion里的cmake-build缓存目录，重新加载CMake项目，避免旧缓存影响配置生效。

2. 修正测试代码 #

补充libvips初始化逻辑，加上异常捕获（libvips的C++接口出错会抛异常），修正后代码：

#include <vips/vips8>
#include <iostream>

using namespace vips;

int main(int argc, char** argv) {
    // 必须最先执行libvips初始化，传入程序入口参数即可
    if (VIPS_INIT(argv[0])) {
        std::cerr << "vips初始化失败: " << vips_error_buffer() << std::endl;
        return 1;
    }

    try {
        // pdfload是VImage的静态方法，不需要先构造空实例
        VImage in = VImage::pdfload("/Users/myuser/CLionProjects/untitled3/files/doc.pdf");
        in.write_to_file("/Users/myuser/CLionProjects/untitled3/output/img.jpeg");
    } catch (const VError& e) {
        std::cerr << "文件处理失败: " << e.what() << std::endl;
        vips_shutdown();
        return 1;
    }

    vips_shutdown();
    return 0;
}

3. 验证PDF依赖（可选，解决运行时错误） #

如果重新编译后链接正常，但是运行提示没有pdfload操作，说明本地libvips没装PDF解析后端，用Homebrew执行以下命令补装依赖即可：

brew install poppler
brew reinstall vips

装完执行vips -l | grep pdfload，能输出对应条目就说明PDF加载功能正常。

注意：如果你用的是Rosetta转译的x86_64版本CLion，要确保你链接的libvips也是x86_64架构的，不要和arm64原生Homebrew安装的库混装，否则会出现架构不匹配的链接错误。

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