三天掌握智能合约开发：Geth 客户端从入门到实战

在上一期内容中，我们介绍了智能合约开发的主要工具和基础概念。本期将聚焦于 Geth 客户端 的详细使用，带你从环境搭建到实际挖矿、转账操作，快速上手这一核心工具。

Geth（Go Ethereum）是以太坊协议的三大官方实现之一，使用 Go 语言编写并完全开源。它支持多平台安装，包括 Windows、Linux、macOS 甚至移动端系统。通过 Geth，开发者可以管理账户、进行挖矿、转移以太币，以及部署和执行智能合约。

一、Geth 的安装与启动

若尚未安装 Geth，建议先完成基础环境配置。Windows 用户可直接从官网下载安装包执行安装，Linux 和 macOS 用户则可通过包管理器或源码编译安装。

1.1 直接启动测试网络

在终端输入 geth 命令可直接启动一个本地测试网络，默认运行在 30303 端口。使用 Ctrl + C 即可关闭该网络。但这种启动方式不会保存区块链数据，重启后数据将丢失，因此仅适用于临时测试。

1.2 初始化私有链

为持久化保存数据，我们通常需要初始化一个固定的本地私有链。步骤如下：

1. 创建项目目录和创世区块配置文件：

   mkdir geth
   cd geth
   touch genesis.json
   mkdir mychain

2. 编辑 genesis.json 文件，配置创世区块参数。以下是一个参考配置：

   {
     "config": {
       "chainId": 666,
       "homesteadBlock": 0,
       "eip150Block": 0,
       "eip155Block": 0,
       "eip158Block": 0,
       "byzantiumBlock": 0,
       "constantinopleBlock": 0
     },
     "alloc": {},
     "difficulty": "0x400",
     "extraData": "",
     "gasLimit": "0xffffffff",
     "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
     "timestamp": "0x00"
   }

   注意：

   • 将 gasLimit 设置为最大值可避免后续部署合约时因 Gas 不足而失败。
   • 明确设置 byzantiumBlock 为 0 可兼容新版 Truffle 框架，避免拜占庭硬分叉相关的问题。

3. 执行初始化命令，指定数据目录和创世块文件：

   geth --datadir ./mychain init ./genesis.json

初始化完成后，区块链数据将保存在 mychain 目录中，重启后仍可继续使用。

二、进入 Geth 控制台与基础操作

初始化完成后，可通过以下命令启动节点并进入交互式控制台：

geth --networkid "30" --nodiscover --datadir="mychain" console 2>>"mychain/err.log"

参数说明：

• --networkid：设置网络 ID，用于区分不同区块链网络。
• --nodiscover：禁止节点被发现，确保搭建的是私有链。
• --datadir：指定区块链数据存储目录。
• console 2>>：将错误日志重定向到指定文件，便于排查问题。

若后续需要部署智能合约或允许外部连接，可添加 RPC 相关参数：

geth --networkid "30" --nodiscover --datadir="./mychain" console 2>>"mychain/err.log" --rpc --allow-insecure-unlock

在控制台中输入 eth.getBlock(0) 可查看创世区块详情，验证之前设置的 gasLimit 和 difficulty 是否生效（数值会被转换为十进制显示）。输入 exit 或按下 Ctrl + D 即可退出控制台。

三、账户管理：创建、解锁与查看

在 Geth 控制台中，可以执行以下账户操作：

3.1 查看现有账户列表

eth.accounts

3.2 创建新账户

personal.newAccount("pay")
personal.newAccount("collect")

此处输入的字符串（如 "pay"）作为私钥的加密密码，而非账户名。区块链中实际标识用户的是生成的钱包地址。

3.3 解锁账户

进行转账等敏感操作前，需先解锁账户：

personal.unlockAccount(user1)

账户解锁后一段时间会自动重新锁定，需再次手动解锁才能操作。

3.4 删除账户

控制台内无法直接删除账户，需手动删除数据目录下对应的私钥文件。

宿主机命令：
除了控制台，也可在系统终端中直接管理账户：

geth account list      # 列出所有账户
geth account new       # 创建新账户

删除账户同样需要手动移除相关文件。

👉 查看实时账户管理工具

四、挖矿与转账实战

以下操作均在 Geth 控制台中执行。

4.1 设置矿工与挖矿

默认第一个账户为矿工，可通过以下命令验证：

eth.coinbase                  // 查看当前矿工地址
eth.getBalance(eth.accounts[0]) // 查看余额

启动和停止挖矿：

miner.start()    // 开始挖矿
miner.stop()     // 停止挖矿
miner.getHashrate() // 查看挖矿算力

4.2 执行转账操作

1. 定义交易双方地址（请替换为你的实际地址）：

   user1 = "0xdeada991bda83c68e2e4428d75bc86d59e3a4efb"
   user2 = "0x9623aaf34567f3edb7ae0530bef9147f3de7b106"

2. 解锁发送方账户并转账：

   personal.unlockAccount(user1)
   amount = web3.toWei(1, "ether")
   eth.sendTransaction({from: user1, to: user2, value: amount})

3. 查看待处理交易：

   eth.pendingTransactions

重要提示：转账交易需被矿工打包并达成网络共识后才能生效。在私有链中，需启动挖矿（miner.start()）一段时间（通常几秒）以确认交易。完成后即可查询余额验证：

eth.getBalance(user2)  // 收款方余额增加
eth.getBalance(user1)  // 付款方余额减少

五、常见问题

1. Geth 启动失败怎么办？

首先检查错误日志（默认输出或通过 2>> 重定向的文件），常见问题包括端口占用、数据目录权限不足或创世块配置错误。

2. 交易一直处于 pending 状态？

确保矿工正在运行（miner.start()），且发送方账户已解锁并有足够余额支付交易费和转账金额。

3. 如何重置私有链？

删除数据目录（如 mychain）并重新执行 geth init 即可完全重置链状态，所有账户和交易历史将被清除。

4. 控制台命令不生效？

请确认你是否已进入 Geth JavaScript 控制台（提示符为 >），部分命令仅在控制台内有效，在系统终端中无效。

5. 为什么需要设置 byzantiumBlock？

这是为了兼容以太坊拜占庭硬分叉后的新特性，尤其是智能合约相关的操作码变化。设置为 0 可确保本地链与最新开发工具兼容。

6. 如何让其他节点连接我的私有链？

需共享创世块文件（genesis.json），并让对方使用相同的 networkid 启动 Geth。同时确保网络连通且未使用 --nodiscover。

通过以上学习，你已经掌握了 Geth 客户端的核心操作，包括私有链搭建、账户管理、挖矿和转账。这些是智能合约开发和区块链交互的基础。如需进一步探索高级功能或最新特性，建议持续关注官方文档和开发者社区。