4. 开发环境准备：Python3、openssl、gmssl库的安装与配置

做SM3之前，得先把“家伙”备齐。说实话，我见过不少新手一上来就写代码，结果跑起来各种“ModuleNotFoundError”或“command not found”，白白浪费半天排查。所以这一章，咱们把Python3、OpenSSL命令行、gmssl库这三个核心工具捋清楚。

4.1 Python3环境检查与安装

SM3的接口我们用Python调用，所以Python3是必须的。我个人习惯先看看系统自带的版本——很多Linux发行版已经预装了Python3。

python3 --version
# 或者
python --version

如果输出版本号（比如Python 3.8+），那就省事了。如果提示“command not found”，就需要自己装。

不同系统的安装方式我列在下面，你照着来就行：

装完再跑一次 python3 --version，确认版本号出来了。嗯，这一步别跳过，我见过有人装完忘了把Python加到PATH，折腾半天。

4.2 OpenSSL命令行工具

你可能要问：我们用Python调用SM3，为啥还要装OpenSSL？其实OpenSSL是个很好的“对照计算器”。写代码前，先拿OpenSSL算一遍SM3的哈希值，然后跟你的程序输出对比，立马就能发现对错。说白了，它就是调试的锚点。

OpenSSL本身支持SM3——但注意，1.1.1版本以上才支持。检查方式：

openssl version

如果版本低于1.1.1，或者输出“OpenSSL 1.0.2”之类的，需要升级。升级命令因系统而异：

openssl dgst -sm3 /dev/null 2>&1 | grep -i sm3

4.3 gmssl库的安装

终于轮到主角了。gmssl是Python的国产密码学库，封装了SM3、SM4等算法。安装其实就一条命令：

pip install gmssl

如果你同时装了Python2和Python3，记得用 pip3 而不是 pip：

pip3 install gmssl

如果要指定版本，目前最新稳定版是3.2.2，我在项目中一直用这个，没出过问题：

pip install gmssl==3.2.2

装完可以快速验证一下：

python3 -c "import gmssl; print(gmssl.__version__)"

输出版本号就表示成功了。如果报“No module named 'gmssl'”，八成是你用pip装到了Python2的环境里。解决办法：改成 pip3，或者检查当前Python路径：

which python3
python3 -m pip install gmssl

4.4 环境验证——三合一对账

三个东西都装好了，怎么确认它们能协同工作？我最喜欢的方式是：用同一个消息，分别用OpenSSL命令、Python的gmssl库、以及Python内置的hashlib（如果有SM3）算一遍三样结果。

先用OpenSSL算：

echo -n "abc" | openssl dgst -sm3

输出类似 SM3(stdin)= 66c7f0f462eeedd9d1f2d46bdc10e4e24167c4875cf2f7a2297da02b8f4ba8e0。

再用Python的gmssl算：

python3 -c "
from gmssl.sm3 import sm3_hash
msg = b'abc'
print(sm3_hash(msg))
"

把两个结果对比，应该完全一致。如果不一致，八成是输入编码问题——OpenSSL的 -n 表示无换行，而Python里如果写成 b'abc\n' 就会不同。记住：消息内容必须完全一样，包括换行符和空格。

4.5 整体环境架构图

下面这张图帮你理清这三样东西的关系。你把它当成开发环境“全家福”就对了。

从上往下看，操作系统是地基，Python3是中间层，gmssl库才是我们直接调用的工具。右边的OpenSSL命令行负责对标验证。这样的四层结构，跑通之后你就可以放心往下写代码了。

4.6 常见问题速查

• pip安装超时或失败：换国内源，比如 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple gmssl
• import gmssl报“找不到指定模块”：Windows用户检查OpenSSL动态库路径，Linux用户试试 ldconfig
• OpenSSL不支持SM3：确认版本≥1.1.1，或者用 openssl dgst -list | grep sm3 查看支持列表
• Python脚本中哈希结果与OpenSSL不一致：对比输入消息是否完全一致（尤其注意换行符 \n 和空格）。我曾在消息末尾多了一个空格，排查了两小时才找到……