VS2019下编译libwebsockets 4.0的完整指南：从OpenSSL配置到生成工程文件

VS2019下编译libwebsockets 4.0的完整指南：从OpenSSL配置到生成工程文件

最近在折腾一个需要高性能WebSocket服务的项目，环境限定在Windows，开发工具是Visual Studio 2019。找了一圈，libwebsockets 这个轻量级C库在性能和灵活性上都很对胃口，但官方文档对Windows+VS2019的编译流程讲得比较简略，尤其是依赖库的集成，让不少开发者望而却步。我自己踩了一遍坑，从准备依赖库到最终在VS里成功编译出libwebsockets 4.0的动态库和静态库，整个过程需要不少细节操作。这篇文章就是一份详细的实战记录，目标读者是那些需要在Windows平台下，特别是使用VS2019进行C/C++网络开发的同行们。我会把重点放在OpenSSL和zlib这两个关键依赖的配置上，并分享几个编译过程中容易卡住的地方及其解决方案。希望这份指南能帮你省下几个小时甚至几天的摸索时间。

1. 环境准备与依赖库编译

在开始编译libwebsockets之前，我们需要一个干净、可控的构建环境。核心工作集中在三个部分：获取libwebsockets源代码、安装构建工具CMake，以及预先编译好两个关键的依赖库——OpenSSL和zlib。很多人编译失败，问题往往就出在依赖库的版本或编译选项不匹配上。

首先，我们需要获取所有必要的源代码和工具。建议创建一个独立的工作目录，比如 D:\Dev\libwebsockets_build，将所有相关文件都放在这里，便于管理。

• libwebsockets 4.0 源代码：直接从其官方GitHub仓库的Release页面下载4.0版本的源码压缩包（如 libwebsockets-4.0.0.zip）。解压到工作目录下，例如 D:\Dev\libwebsockets_build\libwebsockets-4.0。
• CMake 3.17 或更高版本：虽然标题提到了3.17，但使用当前稳定的3.25+版本完全没问题，且能更好地兼容新系统。从CMake官网下载Windows x64安装程序，安装时记得勾选“Add CMake to the system PATH for all users”选项，这样可以在任意命令行中直接使用cmake命令。
• OpenSSL 1.1.1 系列源码：这里是一个关键决策点。原始资料提到了OpenSSL 1.0.2u，但这个版本已经停止支持很久了，存在安全风险。对于新项目，强烈建议使用 OpenSSL 1.1.1 的稳定版本（如1.1.1t）。从OpenSSL官网下载源码压缩包（如 openssl-1.1.1t.tar.gz），解压到工作目录。
• zlib 1.2.11 或更高版本：zlib的版本要求相对宽松，1.2.11是一个广泛使用的稳定版本。从其官网下载源码（如 zlib1211.zip）并解压。

接下来是编译依赖库，这是整个流程中最需要耐心的一步。我们将使用VS2019自带的开发者命令行工具来进行编译，因为它已经配置好了所有的环境变量。

1.1 编译OpenSSL 1.1.1

打开 “x64 Native Tools Command Prompt for VS 2019”。这个命令行工具至关重要，它确保了编译环境是64位的，并且能正确找到VS的编译器和链接器。

# 切换到你解压OpenSSL源码的目录
cd D:\Dev\libwebsockets_build\openssl-1.1.1t

# 配置OpenSSL生成Makefile，指定安装前缀为当前目录下的dist文件夹
perl Configure VC-WIN64A no-asm --prefix=D:\Dev\libwebsockets_build\openssl-1.1.1t\dist

# 执行编译和安装
nmake
nmake install