Windows下用Conan安装zlib后运行程序提示zlib1.dll缺失如何解决？

问题原因 #

Windows系统运行可执行文件时，只会在系统默认搜索路径（如系统目录、当前exe所在目录、PATH环境变量包含的路径）查找DLL文件。你通过Conan安装的zlib动态库（zlib1.dll）不在这些路径里，所以编译时编译器能找到链接库完成编译，但运行时系统找不到对应的DLL。

修复方法 #

• 手动复制DLL到exe目录

  1. 用Conan命令定位zlib的安装路径：

     # 查看已安装的zlib版本
     conan list zlib:*
     # 获取对应版本的bin目录路径
     conan inspect zlib/[你的zlib版本号] --attribute=bin_paths
     

  2. 找到该bin目录下的zlib1.dll，复制到compressor.exe所在的文件夹，直接运行exe即可。

• 用Conan Deploy自动同步DLL
  在项目的conanfile.txt中添加deploy配置：

  [deploy]
  bin=True
  

  重新执行conan install命令，Conan会自动将zlib的DLL复制到构建目录的bin文件夹下，直接从该目录运行compressor.exe即可。

• 静态链接zlib（无需DLL）
  安装zlib时指定使用静态库，这样编译时会把zlib代码直接嵌入exe，彻底避免DLL依赖问题：

  # Release版本
  conan install . -s build_type=Release -o zlib:shared=False
  # Debug版本
  conan install . -s build_type=Debug -o zlib:shared=False
  

  重新编译项目后，生成的exe可直接运行。

• 临时添加PATH环境变量
  将zlib的bin目录路径添加到系统PATH环境变量中，系统就能全局找到该DLL。但不推荐长期使用，容易引发多版本依赖冲突。

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