首页 > 默认分类 > 正文

安装build-essential和curl(如果尚未安装)

时间： 2026-02-17 2:21 阅读数： 2人阅读

Ubuntu上搭建以太坊开发环境：从零开始的详细指南**

以太坊作为全球领先的智能合约平台，为去中心化应用（DApps）的开发提供了强大的基础设施，对于开发者而言，在稳定、灵活的操作系统上搭建高效的开发环境至关重要，Ubuntu，作为最受欢迎的Linux发行版之一，以其友好的用户界面、丰富的软件资源和强大的社区支持，成

随机配图
为了许多以太坊开发者的首选，本文将详细介绍如何在Ubuntu系统上,从零开始搭建一个完整的以太坊开发环境。

准备工作：安装Ubuntu系统

在开始之前，你需要确保一台已经安装好Ubuntu操作系统的计算机，推荐使用Ubuntu 20.04 LTS或22.04 LTS版本,因为它们提供了长期的支持和更好的稳定性。

  1. 下载Ubuntu镜像：访问Ubuntu官方网站（https://ubuntu.com/download/desktop）下载适合你硬件架构的桌面版ISO镜像。
  2. 制作启动盘：使用Rufus（Windows）或balenaEtcher（跨平台）等工具，将ISO镜像写入U盘,制作成可启动的安装盘。
  3. 安装Ubuntu：将U盘插入计算机，重启并从U盘启动，按照屏幕提示完成Ubuntu的安装过程，安装过程中建议选择“正常安装”并勾选“安装第三方软件”,以确保后续驱动的兼容性。

安装完成后,建议先更新系统软件包列表和已安装的软件：

sudo apt update
sudo apt upgrade -y

核心开发工具安装

以太坊开发主要涉及编程、节点运行、智能合约编译与部署等环节,以下是一些核心工具的安装方法。

安装Solidity编译器（Solc）

Solidity是以太坊智能合约的主要编程语言,我们需要安装Solidity编译器来编译合约代码。

# 安装Solidity（通过PPA，推荐）
sudo add-apt-repository ppa:ethereum/ethereum
sudo apt update
sudo apt install -y solc
# 验证安装
solc --version

安装Node.js和npm

Node.js是运行以太坊开发框架（如Truffle、Hardhat）和DApps前端的基础，npm（Node Package Manager）则是Node.js的包管理器。

# 推荐使用NodeSource仓库安装较新版本的Node.js
# 以Node.js 18.x为例
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
# 验证安装
node --version
npm --version

安装Python和pip

某些以太坊开发工具（如web3.py的某些组件）可能依赖于Python。

sudo apt install -y python3 python3-pip

安装Geth（Go-Ethereum）

Geth是以太坊官方的Go语言实现的客户端，是一个功能完整的以太坊节点，可以用于同步区块链、发送交易、部署合约等。

# 安装依赖
sudo apt install -y software-properties-common
# 添加以太坊PPA并安装geth
sudo add-apt-repository -y ppa:ethereum/ethereum
sudo apt update
sudo apt install -y geth
# 验证安装
geth version

开发框架与工具选择

除了上述基础工具,选择一个合适的开发框架能极大提高开发效率。

Truffle Suite

Truffle是最流行的以太坊开发框架之一，提供了智能合约编译、测试、部署和一套内置的本地开发链。

# 全局安装Truffle
sudo npm install -g truffle
# 验证安装
truffle version

Hardhat

Hardhat是一个现代化的以太坊开发环境，以其强大的插件系统、优秀的调试体验和TypeScript支持而备受青睐。

# 创建一个新的Hardhat项目（需要先创建一个项目目录）
mkdir hardhat-project
cd hardhat-project
npm init -y
npm install --save-dev hardhat
# 初始化Hardhat项目
npx hardhat
# 验证安装（在项目目录下）
npx hardhat compile

MetaMask浏览器插件

MetaMask是一个浏览器扩展钱包，允许用户与以太坊区块链进行交互,也是DApps开发中测试用户侧行为的重要工具。

  • 访问MetaMask官方网站（https://metamask.io/）下载对应你浏览器的插件（Chrome, Firefox等）。
  • 安装后，按照提示创建并保存好你的助记词（非常重要！）。

配置本地开发网络

为了避免在主网上进行开发和测试产生真实成本,通常会在本地启动一个私有测试网络。

使用Geth启动私有链

# 创建一个目录用于存放私有链数据
mkdir ~/ethereum-private
cd ~/ethereum-private
# 初始化创世区块（需要先创建一个创世区块配置文件genesis.json）
# 示例genesis.json内容：
{
  "config": {
    "chainId": 12345,
    "homesteadBlock": 0,
    "eip150Block": 0,
    "eip155Block": 0,
    "eip158Block": 0
  },
  "alloc": {},
  "coinbase": "0x0000000000000000000000000000000000000000",
  "difficulty": "0x20000",
  "extraData": "",
  "gasLimit": "0x2fefd8",
  "nonce": "0x0000000000000042",
  "mixhash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "timestamp": "0x00"
}
# 使用上述genesis.json初始化
geth --datadir "./data" init genesis.json
# 启动私有节点
geth --datadir "./data" --networkid 12345 --http --http.addr "0.0.0.0" --http.port "8545" --http.api "eth,net,web3,personal,miner"
# 参数解释：
# --datadir: 指定数据目录
# --networkid: 设置网络ID，确保与创世区块中的chainId一致或不同
# --http: 启动HTTP-RPC服务
# --http.addr: 监听地址，0.0.0.0表示允许任何IP连接
# --http.port: HTTP-RPC端口
# --http.api: 暴露的API

启动后,你可以使用MetaMask连接到这个本地节点：

  1. 打开MetaMask,点击网络下拉菜单。
  2. 选择“添加网络”。
  3. 选择“手动添加网络”。
  4. 网络名称：填写“Local Ethereum Testnet”或自定义。
  5. RPC URL：填写 http://localhost:8545 (如果你的geth监听的是本机)。
  6. Chain ID：填写与创世区块和启动参数中一致的ID（如12345）。
  7. 符号（可选）：填写“ETH”。
  8. 保存后,MetaMask就会连接到你的本地私有链。

开发流程示例（以Truffle为例）

  1. 创建Truffle项目：
    truffle init
  2. 编写智能合约：在 contracts 目录下创建一个新的Solidity文件，MyContract.sol。
  3. 编译合约：
    truffle compile
  4. 编写测试脚本：在 test 目录下编写JavaScript或Solidity测试脚本。
  5. 运行测试：
    truffle test
  6. 部署合约：配置 migrations 目录下的部署脚本，然后执行：
    truffle migrate --network development

    （确保 truffle-config.js 中配置了指向你的本地私有链的development网络）。

常见问题与注意事项

  1. 权限问题：在Ubuntu中，使用 sudo 安装全局npm包可能会导致权限问题，建议使用 npm config set prefix ~/.npm-global 配置npm全局安装路径，并将 ~/.npm-global/bin 添加到 PATH 环境变量中。
  2. 端口占用：确保8545（默认HTTP-RPC端口）等端口没有被其他程序占用。
  3. 同步问题：如果连接到测试网（如Ropsten, Goerli），节点同步可能需要较长时间和较多存储空间,本地开发推荐使用私有链或使用Infura等第三方节点服务。

上一篇:

下一篇: