第3章 多语言SDK开发环境搭建
写加密SDK，说白了就是得让不同语言的开发者都能用。我刚开始做适配那会儿，觉得C和Java搭个环境挺简单，结果Python的pip源、Go的GOPATH、Rust的Cargo，每个都踩过坑。嗯，这一章我把五种语言的环境配置捋一遍，顺便说说我碰到过的奇葩问题。
核心思路：每种语言的环境工具链不一样，但目标相同——能让SDK编译通过、测试跑通。配置前先统一用包管理器，减少手搬库的麻烦。
3.1 C语言环境：老司机也得系安全带
C的加密SDK通常依赖OpenSSL或libsodium。我个人习惯在Linux上搞，因为Windows的编译链实在太折腾。
- Ubuntu/Debian：
sudo apt install build-essential cmake libssl-dev - macOS：
brew install cmake openssl - Windows：装Visual Studio Build Tools，外加vcpkg安装openssl
记得检查pkg-config能不能找到库：pkg-config --cflags --libs openssl。我曾经在macOS上没设PKG_CONFIG_PATH，一连报了半小时链接错误——嗯，其实就是Homebrew的openssl装在/usr/local/opt下，需要手工加路径。
小技巧：CMakeLists.txt里用find_package(OpenSSL REQUIRED)，省得手工指定路径。
3.2 Java环境：JCE这玩意儿你别碰
Java的加密SDK多半基于Bouncy Castle或JCA。环境配置其实就两步：装JDK（建议11+），把SDK扔进classpath或当Maven dependency。
- JDK下载：AdoptOpenJDK或Oracle官方
- Maven依赖：
<dependency><groupId>org.bouncycastle</artifactId>bcprov-jdk15on</version>...</dependency>
Java里有个坑叫「无限强度加密策略文件」（JCE Policy）。早年JDK8默认限制AES-256，必须手动替换policy jar。我从JDK9开始就没再见过这个限制，但如果你还在维护老项目……赶紧升JDK吧，省得半夜被叫起来配JCE。
避坑指南：我曾经在CentOS上装了OpenJDK 8，跑AES-256直接抛InvalidKeyException。找了半天发现没装unlimited policy。解决方案：要么升级JDK，要么手动下载替换。我选升级。
3.3 Python环境：版本错乱是噩梦
Python的加密SDK常见cryptography或pycryptodome。环境配置分三步：装Python（别用系统自带2.7）、建虚拟环境、pip install。
# 推荐用pyenv管理Python版本
$ pyenv install 3.10.11
$ pyenv virtualenv 3.10.11 cryp-sdk
$ pyenv activate cryp-sdk
$ pip install cryptography cffi你想想看，如果直接在全局装，下次另一个项目要Python 3.9依赖冲突，哭都来不及。我在项目里见过有人把全局pip install的OpenSSL和cryptography版本不匹配，结果跑分段加密直接Segfault。虚拟环境能救命。
| 组件 | 推荐版本 | 备注 |
|---|---|---|
| Python | 3.8 ~ 3.11 | 3.12开始有些cffi兼容性问题 |
| cryptography | 41.0.x | 支持X25519、AES-GCM |
| pycryptodome | 3.19.x | 轻量，部分算法更快 |
3.4 Go环境：GOPATH早该退休了
Go的加密SDK依赖标准库crypto/...或者第三方库。环境配置：装Go（推荐1.20+），设置GOROOT、GOPATH，现在默认用module mode，连GOPATH都省了。
- 下载Go：官网 tar.gz 或 brew install go
- 验证：
go version - 初始化模块：
go mod init your-sdk - 引入加密包：
go get golang.org/x/crypto/...
我以前有个同事把项目放在GOPATH/src里，然后用旧版go get老是出bug。后来切到module mode，再也没出过路径问题。说白了，现在Go生态已经拥抱module，别再用老路了。
注意：如果你的SDK用到cgo（比如调用C的OpenSSL），记得装好C编译器和OpenSSL dev包，并设置 CGO_ENABLED=1。
3.5 Rust环境：Cargo是你的好朋友
Rust的加密SDK通常是rustls、ring或aes-gcm等crate。环境配置：用rustup安装工具链，然后cargo new项目，在Cargo.toml里加依赖。
$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
$ rustup default stable
$ cargo new my-crypto-sdk
$ cd my-crypto-sdk
$ cargo add ring aes-gcmRust的编译很慢，第一次build要等一会儿。我记得有一次在Raspberry Pi上交叉编译，没装target的链接器，报了一堆链接错误。解决方案：rustup target add aarch64-unknown-linux-gnu 并装好对应的gcc。
3.6 环境搭建总览：一张图搞定
下面这张图把五种语言的环境依赖关系和核心配置步骤串起来了，你照着走基本不会漏。
图里从源码到各语言配置，再到构建工具和测试，基本覆盖了搭建流程。你只需要根据自己语言选对路径就行。
3.7 几个通用的避坑笔记
- 别用系统自带的Python/Go：macOS 自带Python3 是阉割版，Ubuntu 自带的 Go 版本老。我建议一律用版本管理工具装。
- 翻墙？：Go mod、Rust crate、pip 都可能连不上外网。提前配置国内镜像源，比如 Go 设 GOPROXY=https://goproxy.cn,direct。
- 多版本共存：用 pyenv、nvm（No, 这是前端的）、rustup 管理版本，别在系统路径里硬换二进制。
- 记得用 CMake 集成 C：加密库经常需要交叉编译，别写成死路径。
警告：我曾经在Windows上同时装了Cygwin和MinGW，结果CMake找不到OpenSSL。后来统一用MSYS2 + pacman装，才消停。如果团队用Windows，建议统一用WSL2开发，省心很多。
环境搭好之后，你就可以开始真正写加密逻辑了。每种语言的SDK接口风格不同，但底层算法都一样。我下一轮会讲具体的适配模式，但先把基础打牢——环境搭不好，后面全是坑。