4. 开发环境搭建：操作系统、编译器、依赖库配置

开发环境搭不好，后续全是坑。我自己做国密SDK接入时，光OpenSSL版本就踩了好几次雷。这一章，我带你从操作系统选型开始，一步步把环境配稳。

4.1 操作系统选择与准备

我个人习惯用 Ubuntu 20.04 LTS。原因很简单：包新、文档多、用的人也多。CentOS 7也行，但需要额外处理不少老版本库。macOS也能跑，不过动态库路径和系统目录有些差异，新手容易晕。

不管你选哪个，保证是 64位系统，因为国密算法在某些32位平台上性能会打折扣。

操作系统	推荐版本	备注
Ubuntu	20.04 LTS / 22.04 LTS	最省心，apt源齐全
CentOS / Rocky	7.x / 8.x	需额外启用EPEL和PowerTools
macOS	12+ (Monterey+)	Homebrew安装，注意系统目录权限

4.2 编译器工具链

编译器没太多玄学，用系统自带的GCC就行。我记得有一次用Clang编译国密库，遇到一个inline汇编兼容性问题，折腾半天。最后还是换回GCC解决。

推荐版本：GCC 9.4+ 或 Clang 12+。安装命令：

# Ubuntu / Debian
sudo apt install build-essential gcc g++ cmake

# CentOS / Rocky
sudo yum groupinstall "Development Tools"
sudo yum install gcc-c++ cmake

# macOS（通过Homebrew）
brew install gcc cmake

4.3 核心依赖库

这一节最容易被忽视，也最容易出问题。你需要装的有：

• OpenSSL 1.1.1 及以上：国密算法的直接依赖，必须带国密支持编译。
• CMake 3.16+：国密SDK项目构建用的。
• libpthread、libdl：多线程和动态加载，基本系统自带了。
• zlib：部分加密传输会用到压缩。

OpenSSL 编译与安装（重点）

系统自带的OpenSSL可能版本不够，或者没有开启国密模块。我建议自己编译一遍——虽然慢点，但心里踏实。

# 下载源码（以1.1.1w为例）
wget https://www.openssl.org/source/openssl-1.1.1w.tar.gz
tar xzf openssl-1.1.1w.tar.gz
cd openssl-1.1.1w

# 配置时一定要开启国密支持和64位优化
./config --prefix=/usr/local/openssl \
         enable-ec_nistp_64_gcc_128 \
         enable-gost \           # 包含国密相关算法
         shared                  # 生成动态库

make -j$(nproc)
sudo make install

# 确保系统能找到新库
echo '/usr/local/openssl/lib' | sudo tee /etc/ld.so.conf.d/openssl.conf
sudo ldconfig

CMake 安装

CMake 3.16+ 直接 apt 安装即可。如果源太旧，去官网下载二进制：

# 下载最新二进制
wget https://github.com/Kitware/CMake/releases/download/v3.28.1/cmake-3.28.1-linux-x86_64.tar.gz
tar xzf cmake-3.28.1-linux-x86_64.tar.gz -C /opt
# 添加软链接
sudo ln -s /opt/cmake-3.28.1-linux-x86_64/bin/cmake /usr/local/bin/cmake

其他依赖一览

组件	版本要求	安装方式（Ubuntu）
OpenSSL	≥1.1.1	编译安装或apt（保证国密启用）
CMake	≥3.16	apt install cmake 或源码
libpthread	系统自带	无需额外安装
zlib	≥1.2.11	apt install zlib1g-dev
libuuid	可选	apt install uuid-dev（密钥生成需要）

4.4 环境验证

所有东西都装好后，别急着跑项目。先写个最简单的国密SM3测试，确认链路通。

// test_sm3.c
#include <stdio.h>
#include <openssl/evp.h>

int main() {
    unsigned char msg[] = "hello,国密";
    unsigned char hash[32];
    unsigned int len = 0;

    EVP_MD_CTX *ctx = EVP_MD_CTX_new();
    EVP_DigestInit(ctx, EVP_sm3());
    EVP_DigestUpdate(ctx, msg, sizeof(msg));
    EVP_DigestFinal(ctx, hash, &len);

    printf("SM3: ");
    for(int i=0; i<32; i++) printf("%02x", hash[i]);
    printf("\n");
    EVP_MD_CTX_free(ctx);
    return 0;
}

# 编译（注意链接路径）
gcc -o test_sm3 test_sm3.c \
    -I/usr/local/openssl/include \
    -L/usr/local/openssl/lib \
    -lssl -lcrypto -lpthread

./test_sm3
# 输出应类似：SM3: 3ce8a6f9b6b7f7d8...（32字节十六进制）

到这里，基础环境就稳了。整个流程我习惯用一张图串起来，方便后续排查。

图里的箭头方向很明确：操作系统打底 → 编译器 → CMake → 两条支线（OpenSSL和其它依赖）→ 最终验证。只要每一步都跑通，你的国密SDK改造环境就算站稳了。