Windows环境下C项目使用VS Code编译OpenSSL 1.1.1静态库问询

相关库概念说明 #

先明确三类库的核心差异：

• 静态库（Windows下常规后缀为.lib，Linux下为.a）：编译链接阶段会把库的完整代码嵌入到最终生成的.exe可执行文件中，运行时不需要依赖额外的库文件。你之前的理解是正确的，只要静态编译配置正确，用户运行程序不需要额外安装OpenSSL环境。
• 动态库（Windows下后缀为.dll，Linux下为.so即共享对象）：编译链接阶段只会记录库的调用信息，不会嵌入代码，运行时需要对应版本的.dll/.so文件存在于设备上才能正常启动程序，程序体积更小但需要单独携带依赖库。

前置环境准备 #

• 安装VS Code并安装官方C/C++扩展插件
• 安装MSYS2，启动MSYS2的MinGW64终端，执行以下命令安装编译依赖：

pacman -S mingw-w64-x86_64-gcc mingw-w64-x86_64-make mingw-w64-x86_64-perl make

• 将MSYS2安装路径下的mingw64\bin目录添加到系统环境变量PATH，打开系统cmd执行gcc -v能正常输出版本即为配置成功。

编译静态链接Windows运行时的OpenSSL 1.1.1 #

1. 下载OpenSSL 1.1.1版本源码压缩包，解压到本地无中文、无空格的路径下，示例路径为C:\dev\openssl-1.1.1w
2. 打开MinGW64终端，cd进入源码目录：

cd /c/dev/openssl-1.1.1w

3. 执行配置命令，指定静态编译规则、输出路径、运行时链接规则：

./Configure mingw64 no-shared no-asm --prefix=/c/dev/openssl-static -static-libgcc -static-libstdc++

参数说明：

• no-shared：仅生成静态库，不生成动态库
• no-asm：禁用汇编优化，避免编译过程出现兼容性问题
• --prefix后接的路径为编译完成后OpenSSL头文件、静态库的输出路径，可根据需求自行修改
• -static-libgcc -static-libstdc++：指定静态链接GCC运行时，避免生成的静态库依赖MinGW的动态运行时文件

4. 执行编译和安装命令：

make -j$(nproc)
make install

编译完成后你指定的prefix路径下会生成三个文件夹：include（头文件目录）、lib（静态库文件libcrypto.a、libssl.a）、bin（工具可执行文件，项目开发用不上可忽略）

VS Code项目配置引入静态OpenSSL #

假设你已经用VS Code创建好了C项目，修改项目.vscode目录下的三个配置文件即可：

1. c_cpp_properties.json #

将OpenSSL头文件路径添加到includePath中，解决代码补全、头文件找不到的问题：

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/**",
                "C:/dev/openssl-static/include" // 替换为你自己的prefix路径下的include目录
            ],
            "defines": [
                "_DEBUG",
                "UNICODE",
                "_UNICODE"
            ],
            "compilerPath": "C:/msys64/mingw64/bin/gcc.exe", // 替换为你自己的gcc.exe路径
            "cStandard": "c11",
            "cppStandard": "c++17",
            "intelliSenseMode": "windows-gcc-x64"
        }
    ],
    "version": 4
}

2. tasks.json（编译任务配置） #

添加静态库链接参数，注意链接顺序为libssl在前libcrypto在后，同时需要链接Windows系统加密API依赖：

{
    "tasks": [
        {
            "type": "cppbuild",
            "label": "C/C++: gcc.exe 生成活动文件",
            "command": "C:/msys64/mingw64/bin/gcc.exe", // 替换为你自己的gcc.exe路径
            "args": [
                "-fdiagnostics-color=always",
                "-g",
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe",
                "-IC:/dev/openssl-static/include", // 替换为你自己的头文件路径
                "-LC:/dev/openssl-static/lib", // 替换为你自己的静态库路径
                "-lssl",
                "-lcrypto",
                "-lcrypt32",
                "-static" // 全局静态链接，确保最终exe不依赖任何外部动态库
            ],
            "options": {
                "cwd": "C:/msys64/mingw64/bin"
            },
            "problemMatcher": [
                "$gcc"
            ],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ],
    "version": "2.0.0"
}

3. launch.json（调试配置，可选） #

仅需要保证程序路径和编译生成的exe路径一致即可，不需要额外修改OpenSSL相关配置。

效果验证 #

可编写简单测试代码验证静态编译是否成功：

#include <stdio.h>
#include <openssl/ssl.h>

int main() {
    printf("OpenSSL version: %s\n", SSLeay_version(SSLEAY_VERSION));
    return 0;
}

编译生成exe后，将exe单独复制到没有安装OpenSSL、没有配置MinGW环境的Windows设备上运行，能正常输出版本号即为配置成功。

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