3. 开发环境搭建：安装依赖库、配置编译环境 (Linux/Windows)

嗯，我们先聊聊环境。

说白了，国密算法开发的第一步，就是搭好战场。我见过不少同学，代码写好了，结果一编译，缺少这个库，那个版本不对，光折腾环境就耗了半天。这种体验，能劝退不少人。

这一章，我带着你一步步把 Linux 和 Windows 上的开发环境理清楚。不管你是用 Ubuntu、CentOS，还是 Windows 10/11，都能找到对应的方案。

3.1 环境概览：你需要哪些东西

先列个清单，你心里有个底。我们这套课程主要围绕 GmSSL、OpenSSL 国密模块、以及基于 Python 的封装库展开。

我习惯把依赖分成三层：

• 基础工具层：编译工具链、构建系统（gcc, cmake, make）。
• 核心算法库层：GmSSL（3.x 或 2.x）、OpenSSL（1.1.1 或 3.x，带国密支持）。
• 语言绑定层：Python（3.8+）、SWIG（用于自动生成绑定代码）、Cython。

下面这张图，展示了大致的搭建流程和组件关系。你可以把它当作一个路线图，心里有数。

3.2 Linux 环境搭建（以 Ubuntu 20.04/22.04 为例）

先说说 Linux。我个人觉得，这是最舒服的国密开发环境。大多数生产服务器也是 Linux，所以这块我花点时间细讲。

3.2.1 安装基础工具

打开终端，跑下面这几条命令就行。

sudo apt update
sudo apt install -y build-essential cmake git
# 如果需要 GmSSL 2.x，还需要 autoconf、automake
sudo apt install -y autoconf automake libtool

3.2.2 编译 GmSSL 3.x

我最推荐这条路。从 GitHub 拉源码，然后用 CMake 编译。干净利落。

git clone https://github.com/guanzhi/GmSSL.git
cd GmSSL
mkdir build
cd build
cmake ..
make -j$(nproc)
sudo make install
sudo ldconfig

为什么要 -j$(nproc)？说白了，就是用满你 CPU 所有核心来并行编译。第一次编译 GmSSL 可能等个两三分钟，加了它能快将近一倍。

3.2.3 验证安装

跑个简单命令看看结果。

gmssl version
# 输出示例：GmSSL 3.1.0 - OpenSSL 1.1.1d  10 Sep 2019
# 或者：
echo "hello" | gmssl sm3
# 应该输出 SM3 的哈希值

如果能看到版本号或者哈希值，说明安装成功了。

3.3 Windows 环境搭建

Windows 上稍微麻烦一点，但也不是什么难事。我踩过的坑，你基本不用再踩了。

3.3.1 安装工具链

我个人建议直接用 Visual Studio 2022 Community 版。安装时，记得勾选“使用C++的桌面开发”工作负载。然后单独装 CMake。

1. Visual Studio 2022：从 Visual Studio 官网下载，安装器里选“Desktop development with C++”。
2. CMake：从 cmake.org 下载安装包，安装时勾选“Add CMake to system PATH”。
3. Git for Windows：从 git-scm.com 下载，安装时建议选“Use Git from the Windows Command Prompt”。

3.3.2 获取 GmSSL 库

Windows 下我不建议自己编译 GmSSL 源码，除非你有特殊定制需求。更省力的方式是：

• 使用 vcpkg 自动编译：这是最推荐的方式。vcpkg 能自动处理依赖和编译选项。
• 下载预编译的 DLL：有些第三方网站提供了编译好的 GmSSL DLL 文件，但要注意来源是否可靠。

我这里演示 vcpkg 的方式：

git clone https://github.com/microsoft/vcpkg.git
cd vcpkg
.\bootstrap-vcpkg.bat
.\vcpkg integrate install
.\vcpkg install gmssl:x64-windows

等它跑完，GmSSL 的头文件和库文件就放在 vcpkg\installed\x64-windows 目录下了。你想想看，是不是比自己手动配 CMakeLists.txt 省心多了？

3.3.3 配置 Python 环境

不管在哪个平台，Python 我们都统一用 3.8 以上版本。

# Windows 上，从 Python 官网下载安装包，安装时勾选“Add Python to PATH”
python --version  # 确认版本

# 安装我们需要的包
pip install pybind11
pip install cryptography  # 用于对比测试
pip install pycryptodomex

装 pybind11 是为了后面章节做 C++ 扩展准备。cryptography 和 pycryptodomex 是拿来和 GmSSL 做性能对比用的。先装好，后面直接用。

3.4 环境验证脚本

环境搭完了，总得确认一下能不能用。我写了一个简单的 Python 脚本，你跑一下，绿色通过就说明一切正常。

# check_env.py
import sys
import ctypes

def check_gmssl():
    try:
        # 加载动态库
        if sys.platform == "win32":
            lib = ctypes.CDLL("libgmssl.dll")
        else:
            lib = ctypes.CDLL("libgmssl.so.3")
        print("[✅] GmSSL 动态库加载成功")
    except OSError as e:
        print(f"[❌] 加载 GmSSL 失败: {e}")

def check_python_pkgs():
    packages = ["pybind11", "cryptography", "Crypto"]
    for pkg in packages:
        try:
            __import__(pkg.replace("-", "_"))
            print(f"[✅] {pkg} 已安装")
        except ImportError:
            print(f"[❌] {pkg} 未安装")

if __name__ == "__main__":
    print("=== 国密算法开发环境检查 ===")
    check_gmssl()
    check_python_pkgs()
    print("=== 检查完成 ===")

跑一下：python check_env.py。如果全是绿勾，恭喜你，环境算是立住了。

3.5 常见问题与避坑指南

最后，我把自己和团队里遇到过的问题列出来。你可以先看看，万一碰上了，知道怎么处理。

问题现象	可能原因	解决方法
undefined reference to 'GmSSL_version'	链接时库路径没找对，或者库版本与头文件不匹配。	检查 CMakeLists.txt 中的 target_link_libraries 路径，确保指向正确的 .a 或 .so 文件。
Windows 上 python 命令找不到	没添加到 PATH。	重新运行 Python 安装包，勾选“Add Python to environment variables”。
vcpkg 编译 GmSSL 报错	缺少某些 Perl 模块或者 CMake 版本太旧。	安装 Strawberry Perl，升级 CMake 到 3.20 以上。
Linux 下运行时提示 cannot open shared object file	动态库缓存未更新。	运行 sudo ldconfig，并检查 /etc/ld.so.conf 是否包含 /usr/local/lib。