以太坊作为全球第二大区块链平台,其开源特性为开发者提供了深入理解区块链底层运作机制的绝佳机会，亲自编译并运行以太坊的源码，不仅能够让你对网络中的节点、共识、交易处理等核心概念有更直观的认识，也是进行二次开发、协议研究或问题排查的基础，本文将为你详细梳理从零开始编译并运行以太坊源码的全过程。

准备工作：环境与依赖

在开始之前,我们需要搭建一个合适的开发环境，以太坊的官方主要编程语言是Go（Golang），因此我们将以Go版本为例进行介绍。

安装Go语言环境

以太坊对Go版本有特定要求,请务必查阅以太坊官方文档（通常是github.com/ethereum/go-ethereum的README文件）确认当前推荐的Go版本，以较新的版本为例（如1.19或更高）：

  • Linux (Ubuntu/Debian):
    # 可以从Go官网下载tar包解压，或使用包管理器（如apt，但可能版本不是最新）
# 这里推荐从官网下载：https://golang.org/dl/
wget https://golang.org/dl/go1.19.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.19.linux-amd64.tar.gz
# 添加到PATH环境变量
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc
  • macOS:
    # 可以使用Homebrew
brew install go
# 或从官网下载pkg安装
  • Windows: 下载msi安装包，按照提示安装，并确保将Go的bin目录添加到系统PATH环境变量。

安装完成后,可以通过 go version 命令验证安装是否成功。

安装Git

Git是用于克隆以太坊源码版本控制工具。

  • Linux (Ubuntu/Debian): sudo apt-get install git
  • macOS: brew install git (通常已预装)
  • Windows: 从Git官网下载安装。

安装构建工具

  • Linux (Ubuntu/Debian): sudo apt-get install build-essential
  • macOS: Xcode Command Line Tools: xcode-select --install
  • Windows: 通常在Go安装时会自动配置好MinGW或MSVC编译器。

确保网络连接

克隆源码和下载依赖包需要稳定的网络连接。

获取以太坊源码

以太坊的核心Go实现称为 go-ethereum (简称geth)。

  1. 克隆仓库： 打开终端或命令行工具，导航到你希望存放源码的目录，然后执行：

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

    这会在当前目录下创建一个 go-ethereum 文件夹。

  2. 进入源码目录：

    cd go-ethereum

  3. （可选）切换特定版本： 如果你想研究特定版本的以太坊协议，可以切换到对应的标签（tag），切换到以太坊合并前的版本（PoW）：

    git checkout v1.10.19  # 这只是一个示例，具体版本号请查阅文档

    对于最新开发版,可以直接使用 main 分支：

    git checkout main

编译以太坊源码

go-ethereum 使用Go的构建系统来编译。

  1. 下载依赖： 在 go-ethereum 目录下，执行：

    go mod download

    这会下载项目所需的Go模块依赖。

  2. 编译核心组件： go-ethereum 提供了多个可执行程序，如 geth（以太坊客户端）、bootnode（引导节点）、evm（EVM虚拟机测试工具）等，我们可以分别编译它们。

    • 编译 geth（最常用的以太坊节点客户端）：

      make geth

      或者直接使用 go build：

      go build ./cmd/geth

      编译成功后,会在当前目录生成一个名为 geth 的可执行文件（Windows下是 geth.exe）。

    • 编译其他工具（可选）：

      make bootnode  # 编译引导节点
make evm       # 编译EVM测试工具
# 或者
go build ./cmd/bootnode
go build ./cmd/evm

运行以太坊节点

编译完成后,我们就可以运行 geth 来启动一个以太坊节点了，根据你的需求，可以选择不同的运行模式。

初始化节点（创世区块）

如果你是从零开始搭建一个全新的私有网络或测试网络,需要先初始化节点，创建创世区块配置文件。

  • 创建一个配置目录：
    mkdir myethereum
cd myethereum
  • 使用 geth 的 init 命令，并指定一个创世块配置文件（JSON格式），你可以使用 go-ethereum 中的示例配置文件：
    # 回到go-ethereum根目录复制示例配置，或者手动编写
cp /path/to/go-ethereum/genesis.json ./mygenesis.json  # 假设你复制了一个示例genesis.json

    然后初始化：

    /path/to/go-ethereum/geth init --datadir ./mydata mygenesis.json

    这会在 随机配图