安装

---

本页说明如何确认你拿到的 utxo_compiler 是否能运行。utxo_compiler 是命令行程序：你在终端里输入命令，它读取 .ct 合约文件，再输出编译结果。

下载

请先从下载页面获取当前版本的发布包。

支持的平台

• Linux
• Windows 64 位
• Windows 32 位
• macOS：计划支持

---

发布产物结构

Linux 包结构

下载并解压 Linux 包后，目录通常长这样：

utxo_compiler-v1.0.0-linux/
├── bin/
│   └── utxo_compiler    # 可执行文件
├── doc/                 # 文档目录
├── install.sh           # 安装脚本
├── share/apc/stdlib/    # 标准库合约
└── VERSION              # 版本信息

Windows 包结构

Windows 包会额外带上运行所需的动态链接库（DLL）。DLL 可以理解为程序运行时要加载的依赖文件。

utxo_compiler-v1.0.0-windows-64/32/
├── utxo_compiler.exe    # Windows可执行文件
├── libstdc++-6.dll      # C++标准库
├── libgcc_s_seh-1.dll   # 64 位包的 GCC 运行时库
├── libgcc_s_dw2-1.dll   # 32 位包的 GCC 运行时库
├── libwinpthread-1.dll  # 多线程支持库
├── stdlib/              # 标准库合约
├── doc/                 # 文档目录
├── install.bat          # Windows安装脚本
├── DEPENDENCIES.txt     # 依赖库说明
└── VERSION              # 版本信息

---

测试和验证

第一步：确认程序能启动

在终端中进入解压后的目录，然后运行版本检查命令。

Linux 发布包：

./bin/utxo_compiler --version

Debian 或 Ubuntu 安装包：

utxo_compiler --version

Windows 发布包：

.\utxo_compiler.exe --version

如果你是在源码目录中自行构建，生成的可执行文件通常位于 build/bin：

./build/bin/utxo_compiler --version

解压后的 Windows 发布包也可以在 Linux 上用 Wine 做基础验证：

# 如果没有 Wine，需要先安装
sudo apt install wine

wine ./utxo_compiler-v1.0.0-windows-64/utxo_compiler.exe --version
wine ./utxo_compiler-v1.0.0-windows-32/utxo_compiler.exe --version

第二步：编译一个最小合约

准备一个文件 p2pkh.ct：

Contract P2PKH:
    def verify(sig: hex, pubKey: hex):
        pubKeyHash = Hash160(pubKey.Clone())
        EqualVerify(pubKeyHash, self.pubKeyHash)
        result = CheckSig(sig, pubKey)

这段代码的作用是验证“签名是否来自指定公钥哈希对应的私钥”。几个关键点：

• sig：交易签名，花费 UTXO 时由调用方提供。
• pubKey：公钥，合约会计算它的 Hash160。
• self.pubKeyHash：部署合约时写入锁定脚本的目标公钥哈希。
• Clone()：复制 pubKey，因为 Hash160 会消耗传入的值，后面 CheckSig 还要再用一次。

编译：

./bin/utxo_compiler p2pkh.ct

如果编译成功，说明命令行程序、基本语法解析和字节码生成都可以工作。后续可以进入 教程一：P2PKH 合约入门，学习如何调试和调用它。

验证 Windows 包依赖库

如果 Windows 用户反馈程序无法启动，可以检查包里是否包含所需 DLL：

# 检查 Windows 可执行文件依赖哪些 DLL
x86_64-w64-mingw32-objdump -p utxo_compiler.exe | grep "DLL Name"

# 检查 zip 包中是否包含 DLL
python -m zipfile -l dist/utxo_compiler-v1.0.0-windows-64.zip | grep "\.dll"

---

初级开发者易踩坑

• 把路径写错：便携 Linux 发布包通常使用 ./bin/utxo_compiler。Debian 安装包安装后通常直接使用 utxo_compiler。
• Windows 缺 DLL：utxo_compiler.exe 旁边需要放着依赖 DLL，不能只复制一个 .exe。
• .ct 文件名写错：编译命令最后一个参数必须指向真实存在的合约文件。
• 第一次就上链测试：建议先本地编译和调试，通过后再构造真实交易。

---

快速回顾

• utxo_compiler 是命令行编译器，用来把 .ct 合约编译成锁定脚本字节码。
• 安装后先运行 --version，再编译一个最小合约确认环境可用。
• Windows 包需要 .exe 和 DLL 放在一起。
• 如果代码里同一个变量要用两次，通常需要先 .Clone()。

---

下一步

• 比特币基础 — 了解 UTXO 和 BVM 的工作原理

---

🇬🇧 English version