MacOS下CMake构建C库：找到htslib但链接出错如何修改CMakeList.txt？

我之前在MacOS上用CMake构建依赖htslib的项目时，也碰到过类似的链接错误，给你几个实用的排查和修复方向：

1. 修正CMake变量的大小写问题 #

CMake的变量是大小写敏感的，你当前的配置里混用了大小写：

target_link_libraries(projectname ${HTSlib_LIBRARIES})

通常find_package(htslib REQUIRED)导出的变量是全大写的，应该改成：

target_link_libraries(projectname ${HTSLIB_LIBRARIES})

同时，建议把全局的include_directories替换成更现代的目标专属写法，避免污染全局头路径：

target_include_directories(projectname PRIVATE ${HTSLIB_INCLUDE_DIR})

2. 使用现代CMake的导入目标（推荐） #

如果你的htslib版本比较新（通常1.10+的版本会提供），它的CMake配置文件会导出htslib::htslib这个导入目标，直接用这个目标链接会更可靠，不用手动处理变量：

find_package(htslib REQUIRED)
target_link_libraries(projectname PRIVATE htslib::htslib)

这种方式会自动处理头文件路径和库链接逻辑，完全避免变量大小写的坑。

3. 确认htslib的安装路径和CMake搜索范围 #

如果你是手动编译安装的htslib（不是通过Homebrew等包管理器），CMake可能只找到了头文件，但没定位到完整的库文件。可以在执行cmake时指定CMAKE_PREFIX_PATH，指向你的htslib安装目录：

cmake .. -DCMAKE_PREFIX_PATH=/usr/local/htslib  # 替换成你的实际安装路径

如果是用Homebrew安装的，Apple Silicon设备注意路径是/opt/homebrew，Intel设备是/usr/local，确保这个路径在CMake的默认搜索范围内。

4. 查看详细的链接错误信息 #

你当前只看到了链接失败的笼统提示，没有具体错误细节。可以执行make VERBOSE=1，这样会输出完整的链接命令和未定义符号信息，能帮你精准定位问题：

• 如果输出里有undefined reference to 'hts_open'这类信息，说明确实是htslib的库没正确链接；
• 如果是动态库找不到的错误，可能需要临时设置DYLD_LIBRARY_PATH指向htslib的库目录，或者把库路径添加到系统动态库搜索列表里。

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