区块链原理 / 系统课时
配置 Python 区块验证实验环境
配置 Python 区块验证实验环境
本课使用 Python 标准库搭建可重复运行的区块验证实验环境,包括独立虚拟环境、固定脚本入口、JSON 序列化和 SHA-256 哈希计算。完成后,你将获得一个能够稳定生成区块摘要、检测数据变化的最小实验程序,为后续实现区块链接和交易验证提供基础。
学习目标
- 安装并检查 Python 解释器,创建隔离的实验环境。
- 使用
json和hashlib实现确定性的区块序列化与 SHA-256 摘要计算。 - 运行实验脚本,验证字段顺序变化与区块内容修改对哈希结果的影响。
检查 Python 并创建独立环境
实验适用于 Python 3.10 及以上版本,只使用标准库中的 json 和 hashlib,无需安装第三方依赖。建议使用 Python 3.11 或更新的受支持版本。
先确认系统已安装 Python。macOS 或 Linux 在终端执行:
python3 --version
mkdir blockchain-lab
cd blockchain-lab
python3 -m venv .venv
.venv/bin/python --version预期结果:两次版本检查均显示 Python 3.10 或更高版本,并在 blockchain-lab 目录中生成 .venv 虚拟环境。具体版本号取决于本机安装的解释器。
Windows PowerShell 使用以下命令:
py -3 --version
New-Item -ItemType Directory -Path blockchain-lab
Set-Location blockchain-lab
py -3 -m venv .venv
.\.venv\Scripts\python.exe --version预期结果:能够看到 Python 版本信息,当前目录为 blockchain-lab,其中包含 .venv。如果系统没有 py 命令,但已经安装并配置了 Python,可以将 py -3 替换为 python。
虚拟环境用于隔离当前实验与其他项目的依赖。这里直接调用虚拟环境中的 Python 可执行文件,不必激活环境,也可以避开部分 PowerShell 脚本执行策略限制。
在实验目录中创建 verify_block.py。最终需要保留的项目文件只有该脚本;.venv 是可重新生成的本地环境目录。如果使用 Git 管理项目,应将 .venv/ 加入 .gitignore,不要提交虚拟环境文件。
编写确定性的区块摘要脚本
区块哈希计算有一个容易忽略的前提:相同的逻辑数据必须先转换成相同的字节序列。直接依赖字典的插入顺序或默认 JSON 空白格式,可能让语义相同的数据得到不同的哈希值。
本实验使用三个明确的序列化约定:
sort_keys=True:按键名排序,避免字典插入顺序影响序列化结果。separators=(",", ":"):去掉默认的分隔空格,固定 JSON 字节格式。ensure_ascii=False:直接保留 Unicode 字符,再统一编码为 UTF-8 字节。
同时使用 allow_nan=False 拒绝 JSON 标准不支持的 NaN 和 Infinity 数值。实验中的交易金额采用整数,避免浮点数表示问题。
将以下完整代码保存到 verify_block.py:
import hashlib
import json
def canonical_bytes(block: dict) -> bytes:
# 固定键顺序与空白规则,保证相同数据生成相同字节。
return json.dumps(
block,
sort_keys=True,
separators=(",", ":"),
ensure_ascii=False,
allow_nan=False,
).encode("utf-8")
def digest(block: dict) -> str:
return hashlib.sha256(canonical_bytes(block)).hexdigest()
def main() -> None:
block = {
"index": 0,
"previous_hash": "0" * 64,
"transactions": [
{"sender": "alice", "recipient": "bob", "amount": 5}
],
"nonce": 0,
}
# 改变字典键的插入顺序,不应改变区块摘要。
reordered = dict(reversed(list(block.items())))
# 修改参与哈希计算的字段,应得到不同的摘要。
modified = {**block, "nonce": 1}
print("哈希:", digest(block))
print("字段重排一致:", digest(block) == digest(reordered))
print("修改 nonce 后不同:", digest(block) != digest(modified))
# 验证 JSON 编码与解码能还原实验数据。
print("JSON 往返一致:", json.loads(canonical_bytes(block)) == block)
if __name__ == "__main__":
main()该脚本使用索引为 0 的实验区块,前一区块哈希暂用 64 个字符 0 表示,交易包含一笔从 alice 到 bob、金额为 5 的转账记录。这里的交易只是待验证数据,不表示转账已经得到授权或确认。
hashlib.sha256() 对字节序列计算 SHA-256 摘要,hexdigest() 将其转换为 64 个十六进制字符。对于相同输入字节,摘要必定相同;修改输入后,通常会得到完全不同的摘要。
执行脚本并核对输出
保存文件后,在 blockchain-lab 目录中运行。macOS 或 Linux 使用:
.venv/bin/python -c 'import sys; print(sys.prefix != sys.base_prefix)'
.venv/bin/python verify_block.py预期输出:
True
哈希: 364fddd4351c7d72f345366af9ab937cb3f610ce3c9d516d403a9ea6099250da
字段重排一致: True
修改 nonce 后不同: True
JSON 往返一致: True第一行 True 表示当前脚本使用的是虚拟环境解释器,而不是系统解释器。
Windows PowerShell 可使用对应的虚拟环境 Python 执行:
.\.venv\Scripts\python.exe -c "import sys; print(sys.prefix != sys.base_prefix)"
.\.venv\Scripts\python.exe .\verify_block.py预期输出与上面的 macOS/Linux 示例完全相同。由于区块数据固定且序列化规则确定,不同操作系统上的这一测试应生成相同摘要。
四项结果分别说明:实验使用独立解释器、字典键插入顺序不会改变摘要、修改 nonce 能改变摘要,以及 JSON 编解码能够还原原始数据。
可以再做一次手动验证:将 amount 从 5 改为 6,重新运行脚本。此时第一行哈希摘要应改变,但后三项检查仍应输出 True。恢复金额为 5 后,哈希应重新等于原始值。
排查环境问题与明确验证边界
如果实验没有得到预期结果,按以下顺序检查。
| 现象 | 检查与处理 |
|---|---|
找不到 python3 或 py |
检查 Python 是否安装,并确认终端可找到对应命令;安装或调整 PATH 后重新打开终端 |
| 创建虚拟环境失败 | 检查 Python 版本;部分 Linux 发行版需要额外安装与解释器版本匹配的 venv 软件包 |
找不到 verify_block.py |
确认当前工作目录为 blockchain-lab,并检查文件名和扩展名 |
json 或 hashlib 导入异常 |
检查目录中是否存在意外命名为 json.py、hashlib.py 的文件,避免覆盖标准库模块 |
| 同一数据计算出不同哈希 | 核对字段类型、交易数组顺序、UTF-8 编码及 json.dumps() 参数是否完全一致 |
还要区分区块摘要计算与完整区块验证。当前脚本只证明数据可以被确定性编码并计算哈希,没有检查交易签名、账户余额、前一区块是否存在、工作量证明是否满足难度目标,也没有执行节点间共识。
例如,将 previous_hash 设置为 64 个 0 可以计算出合法的 SHA-256 摘要,却不代表它真的指向某个有效的前置区块。后续实现链式验证时,必须独立检查该字段是否等于前一区块实际计算出的摘要。
完成本实验的验收标准是:虚拟环境能独立运行、同一数据重复生成相同的 64 字符摘要、字段插入顺序改变不影响结果、区块内容修改引发摘要变化。保留 verify_block.py,即可继续在此入口上添加区块结构和验证规则。