CMake问题：使用共享Zlib包装库的简单项目无法链接

兄弟，我太懂你这种CMake链接踩坑的痛苦了！尤其是在MSYS这种半交叉环境下，共享库的依赖传递很容易掉链子。你遇到的情况大概率是：mylib作为依赖Zlib/Libzip的共享库，没有把底层依赖的链接信息传递给app，导致app链接时找不到Zlib/Libzip的符号。下面结合MSYS环境的特点，给你一步步排查和解决的方案：

第一步：先把mylib的CMake配置改对 #

mylib作为共享库，必须用正确的CMake语法把依赖传递出去。你的mylib/CMakeLists.txt得这么写才对：

cmake_minimum_required(VERSION 3.15)
project(mylib SHARED)

# 用MSYS包管理器装的依赖，直接用find_package找就行
find_package(ZLIB REQUIRED)
find_package(LibZip REQUIRED)

# 添加共享库源文件
add_library(mylib SHARED mylib.cpp)

# 核心关键：用PUBLIC关键字链接依赖！
# 这样mylib的依赖（Zlib/Libzip）会自动传递给所有链接它的目标（比如app）
target_link_libraries(mylib
    PUBLIC
        ZLIB::ZLIB
        LibZip::LibZip
)

# 把mylib的头文件路径也传递给app，不然app找不到mylib的接口
target_include_directories(mylib
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}
)

别用PRIVATE链接依赖！用PRIVATE的话，这些依赖只会被mylib自己用，不会告诉app，app链接时自然找不到底层符号。

第二步：app的CMake配置只需要管mylib就行 #

app完全不用关心Zlib/Libzip，只要正确链接mylib就够了。app/CMakeLists.txt这么写：

cmake_minimum_required(VERSION 3.15)
project(app)

# 两种方式引入mylib：
# 1. 如果你已经把mylib安装到MSYS的系统路径（比如执行过make install）
find_package(mylib REQUIRED)

# 2. 本地开发没安装的话，直接引入mylib的项目目录
# add_subdirectory(../mylib ${CMAKE_CURRENT_BINARY_DIR}/mylib-build)

# 生成app可执行文件
add_executable(app app.cpp)

# 只需要链接mylib，用PRIVATE就行，因为app不需要把mylib的依赖再传递给别人
target_link_libraries(app
    PRIVATE
        mylib
)

如果用add_subdirectory，要注意路径是相对路径，确保CMake能找到mylib的CMakeLists。

第三步：MSYS环境的特殊坑要避开 #

因为你用的是MSYS Makefiles，这几个点一定要注意：

• 确保你的Zlib和Libzip是MSYS环境下安装的：用pacman -S zlib-devel libzip-devel装，别混用Windows原生的库，不然链接时会出现符号不兼容的问题。
• 必须在MSYS终端里操作：打开MSYS的bash终端，先执行cmake -G "MSYS Makefiles" ..生成Makefile，再执行make，别在Windows的CMD/PowerShell里跑，环境变量和工具链不匹配会出各种奇怪问题。
• 如果是动态库（.dll），编译后mylib的.dll要和app的exe放同目录，或者加到MSYS的PATH里，但你现在是链接阶段失败，所以重点还是前面的CMake配置。

第四步：排查错误的小技巧 #

如果还是链接失败，把错误信息贴出来（比如是不是undefined reference to某个zlib的函数）。你还可以在app的CMakeLists里加两行调试代码：

get_target_property(MYLIB_DEPENDS mylib INTERFACE_LINK_LIBRARIES)
message(STATUS "mylib传递给app的依赖：${MYLIB_DEPENDS}")

执行cmake时看输出，如果里面没有ZLIB::ZLIB和LibZip::LibZip，那肯定是mylib的target_link_libraries用错了关键字（比如用了PRIVATE），改回PUBLIC就好。

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