Win10 MSYS2环境编译libnetconf2时libssh链接失败问题

问题原因及解决方案 #

这个问题是MSYS2环境下CMake路径探测逻辑和库版本不匹配导致的，可按以下步骤排查解决：

• CMake找不到LibSSH的问题
  libnetconf2自带的FindLibSSH.cmake模块的探测规则未适配MSYS2的目录结构，无法识别系统中已安装的libssh的cmake配置文件。优先让CMake调用libssh官方提供的配置文件，执行cmake时添加参数即可：

  cmake -DCMAKE_PREFIX_PATH=/usr ..
  

• 手动传参后链接报错的问题
  你之前传入的LIBSSH_LIBRARIES=/usr/lib/是目录路径，CMake无法将其转换为正确的链接参数，导致编译时没有实际链接libssh库。如果需要手动指定参数，要传入完整的头文件根路径和库文件路径：

  cmake -DLIBSSH_INCLUDE_DIR=/usr/include -DLIBSSH_LIBRARY=/usr/lib/libssh.dll.a ..
  

  注意头文件路径要指定到/usr/include而非/usr/include/libssh，因为libnetconf2代码中引用libssh头文件的格式是#include <libssh/libssh.h>，路径层级不对会导致头文件找不到。
• 环境适配问题（最常见踩坑点）
  如果你要编译原生Windows平台的程序，不应该使用MSYS子系统版本的libssh，需要先卸载已安装的msys版libssh-devel，安装mingw64专属的libssh包：

  # 卸载msys版libssh
  pacman -R libssh-devel
  # 安装mingw64版libssh
  pacman -S mingw-w64-x86_64-libssh
  

  之后切换到Mingw64终端执行cmake，不需要加任何额外参数即可正常识别libssh，完成编译。

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