如何在C++项目中通过CMake引入ImageMagick/Magick++库

你遇到的核心问题是：通过git submodule拉取的ImageMagick源码目录没有CMakeLists.txt，没法直接用add_subdirectory集成。结合你命令行编译正常的情况，给你三种可行的解决办法：

方法1：用Magick++-config自动拿编译/链接参数 #

既然命令行能正常编译，说明你已经搞定了ImageMagick的编译工作，直接用它自带的Magick++-config工具就能自动获取CMake需要的参数，不用手动写路径。

在顶层CMakeLists.txt里加这段代码：

# 先指定submodule里Magick++-config的路径（如果没在系统PATH里的话）
set(MAGICKPP_CONFIG "${PROJECT_SOURCE_DIR}/external/image_magick/bin/Magick++-config")

# 获取编译需要的CXXFLAGS
execute_process(
    COMMAND ${MAGICKPP_CONFIG} --cxxflags
    OUTPUT_VARIABLE MAGICKPP_CXX_FLAGS
    OUTPUT_STRIP_TRAILING_WHITESPACE
)

# 获取链接需要的库参数
execute_process(
    COMMAND ${MAGICKPP_CONFIG} --libs
    OUTPUT_VARIABLE MAGICKPP_LIBRARIES
    OUTPUT_STRIP_TRAILING_WHITESPACE
)

# 给你的项目目标添加参数
add_executable(你的目标名 你的源码文件.cpp)
target_compile_options(你的目标名 PRIVATE ${MAGICKPP_CXX_FLAGS})
target_link_libraries(你的目标名 PRIVATE ${MAGICKPP_LIBRARIES})

注意：Magick++-config的路径要根据你实际编译后的位置调整，比如如果编译到了submodule的build目录里，就改成对应路径。

方法2：手动指定头文件和库路径 #

要是不想用工具，直接硬编码路径也行——毕竟你命令行能编译，肯定知道头文件和库文件在哪。

在顶层CMakeLists.txt里这么写：

# 指定Magick++的头文件目录
set(MAGICKPP_INCLUDE_DIR "${PROJECT_SOURCE_DIR}/external/image_magick/include/Magick++")
# 别忘了加ImageMagick核心头文件的目录
set(MAGICK_CORE_INCLUDE_DIR "${PROJECT_SOURCE_DIR}/external/image_magick/include/ImageMagick-7")

# 指定库文件所在目录
set(MAGICKPP_LIB_DIR "${PROJECT_SOURCE_DIR}/external/image_magick/lib")

# 查找需要的库文件
find_library(MAGICKPP_LIB NAMES Magick++ PATHS ${MAGICKPP_LIB_DIR})
find_library(MAGICK_CORE_LIB NAMES MagickCore PATHS ${MAGICKPP_LIB_DIR})
find_library(MAGICK_WAND_LIB NAMES MagickWand PATHS ${MAGICKPP_LIB_DIR})

# 配置你的项目目标
add_executable(你的目标名 你的源码文件.cpp)
target_include_directories(你的目标名 PRIVATE ${MAGICKPP_INCLUDE_DIR} ${MAGICK_CORE_INCLUDE_DIR})
target_link_libraries(你的目标名 PRIVATE ${MAGICKPP_LIB} ${MAGICK_CORE_LIB} ${MAGICK_WAND_LIB})

提示：库文件名可能因版本、编译选项不同有变化，比如带版本后缀的libMagick++.so.7，或者Windows下的.lib文件，根据实际情况调整NAMES后面的内容就行。

方法3：先给submodule里的ImageMagick做CMake编译（最规范） #

如果你的submodule拉的是新版本ImageMagick，其实官方已经支持CMake构建了——可能你克隆的分支不对，建议切到main或最新发布分支。然后手动编译submodule里的ImageMagick：

先在命令行执行：

cd external/image_magick
mkdir build && cd build
# 指定安装到submodule内部的install目录，避免污染系统
cmake .. -DCMAKE_INSTALL_PREFIX=../install
make -j$(nproc)  # 多线程编译，速度快
make install

编译完成后，在顶层CMakeLists.txt里用find_package集成：

# 指定ImageMagick的CMake配置文件路径
set(ImageMagick_DIR "${PROJECT_SOURCE_DIR}/external/image_magick/install/lib/cmake/ImageMagick")
find_package(ImageMagick REQUIRED COMPONENTS Magick++)

# 关联到你的项目目标
add_executable(你的目标名 你的源码文件.cpp)
target_link_libraries(你的目标名 PRIVATE ImageMagick::Magick++)

这种方法最适合长期维护的项目，CMake会自动处理依赖和版本问题。

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