创建一个目录用于存放节点数据

2026-01-19 币界百科

从零开始：以太坊源码的获取、编译与运行指南

对于任何希望深入理解以太坊工作原理的开发者、研究员或技术爱好者来说，阅读和运行以太坊的源码都是一项至关重要的技能，它不仅仅是停留在理论层面，更是真正“触摸”区块链核心逻辑的唯一途径，本文将带你一步步走过从零开始，获取、编译并运行以太坊源码的全过程，为你打开探索以太坊底层世界的大门。

在开始之前,我们先明确一下目标，直接阅读像以太坊这样复杂系统的源码，可能会让人望而生畏，但它的回报是巨大的：

深刻理解核心概念：通过阅读源码，你不再是“道听途说”什么是“状态树”、“交易池”或“共识机制”，而是能亲眼看到它们是如何在代码中被创建、修改和交互的。
掌握调试与排查能力：当你在DApp开发或节点运行中遇到棘手问题时，源码是你最强大的“调试器”，你能直接定位到问题的根源，而不是依赖第三方工具的模糊报告。
为二次开发奠定基础：如果你想构建自己的客户端、实现新的共识算法或添加自定义功能，对源码的熟悉是必不可少的先决条件。
参与社区贡献：以太坊是一个开源项目，理解源码是为其提交代码修复、优化甚至新功能的第一步。

在开始之前,你需要准备一个合适的开发环境，以太坊的官方客户端（Go语言版）主要在Linux和macOS上开发和测试，虽然Windows也可以通过WSL（Windows Subsystem for Linux）来运行，但为了获得最佳体验，推荐使用Linux或macOS。

核心依赖：

Go语言环境：以太坊的Go客户端（geth）是用Go语言编写的，你需要安装一个兼容的Go版本（建议使用最新的稳定版）。
- 安装Go：你可以从Go官网下载安装包，或使用系统的包管理器进行安装。
- 验证安装：在终端输入 go version，如果显示版本号则表示安装成功。
Git：用于从代码仓库克隆源码。
- 安装Git：同样可以从官网下载或使用包管理器安装。
- 验证安装：在终端输入 git --version。
构建工具：
- Linux (Debian/Ubuntu): sudo apt-get install build-essential
- macOS: 如果使用Xcode Command Line Tools，通常已经包含，可以通过 xcode-select --install 来确保。
(可选) C 编译器：某些依赖项可能需要它。

以太坊的Go客户端源码托管在GitHub上,我们将使用git命令将其克隆到本地。

克隆官方Go客户端的仓库（go-ethereum）：

git clone https://github.com/ethereum/go-ethereum.git

以太坊的完整源码已经在你本地了,你可以用ls命令查看一下，会发现有cmd、consensus、core、eth、p2p等目录，这些目录对应着以太坊的不同模块。

获取到源码后,下一步就是将其编译成我们可以在命令行中执行的可执行文件，以太坊Go客户端的核心可执行文件叫做geth（Go-Ethereum的缩写）。

这个过程非常简单,得益于Go强大的工具链。

编译成功后,最令人兴奋的一步来了——运行你亲手编译的以太坊节点。geth是一个功能极其强大的工具，我们先用它来启动一个最基础的私有网络节点。

初始化一个数据目录

每个geth节点都需要一个地方来存储区块链数据，包括区块、交易和状态，我们首先创建一个目录来存放这些数据，并初始化它。

# 初始化这个目录，这会创buildgenesis.json文件
./build/bin/geth --datadir node_data init

执行后,node_data目录下会生成一个genesis.json文件，这是创世区块的配置文件，你可以用文本编辑器打开它，看到初始的配置参数。

启动节点

我们启动一个私有的、不与外部网络连接的节点，并让它能够进行JavaScript控制台交互。

./build/bin/geth --datadir node_data --networkid 12345 --nodiscover console

我们来分解一下这个命令的参数：

启动后,你会看到节点开始同步区块，因为是第一次运行，它会从创世区块开始，很快，你会进入一个以 > 开头的命令行提示符。

在控制台中与节点交互

你可以使用一些内置的JavaScript API来与你的节点进行交互了。

查看账户列表：
```
eth.accounts
```
初始时,列表是空的。
创建一个新账户：
```
personal.newAccount("请输入你的密码")
```
输入密码后,它会返回一个以0x开头的地址，这个账户现在存在于你的节点中，但还没有任何以太币。
查看账户余额：
```
eth.getBalance("你的账户地址")
```
余额会是 0。
查看挖矿状态：
```
eth.mining
```
会返回 false，因为节点还没有开始挖矿。
开始挖矿：为了让账户有余额，我们需要挖矿，我们先指定一个“Coinbase”地址，也就是挖矿奖励的接收地址。
```
// 将第一个账户设置为挖矿奖励接收地址
miner.setEtherbase(eth.accounts[0])
// 开始挖矿
miner.start(1) // 1代表使用1个CPU核心
```
现在你会看到终端开始出现大量的哈希计算信息,这意味着你的节点正在为网络产生新的区块。
再次查看余额：挖矿一段时间后（大约15秒左右产生一个区块），再次查看余额：
```
eth.getBalance(eth.accounts[0])
```
你会发现余额已经从 0 变成了 5000000000000000000（5 ETH，因为以太坊的奖励单位是 Wei，1 ETH = 1e18 Wei）。
停止挖矿：
```
miner.stop()
```