Ubuntu系统下以太坊开发环境搭建全指南

sudo apt install -y build-essential curl wget git

安装Geth（以太坊官方客户端）

Geth（Go-Ethereum）是以太坊官方的Go语言实现，是一个功能完整的以太坊节点客户端，可以用于同步区块链、挖矿（已不主流）、发送交易以及运行智能合约。

1. 添加以太坊PPA源：

   sudo add-apt-repository -y ppa:ethereum/ethereum
   sudo apt update

2. 安装Geth：

   sudo apt install -y ethereum

3. 验证安装：

   geth version

   如果看到版本信息,则表示安装成功。

安装Node.js和npm（用于开发工具链）

许多以太坊开发工具（如Truffle, Hardhat）以及前端框架（如React）都需要Node.js环境。

1. 通过NodeSource源安装Node.js（推荐版本LTS，如18.x）：

   # 下载NodeSource的Node.js 18.x LTS安装脚本
   curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
   # 安装Node.js和npm
   sudo apt install -y nodejs

2. 验证安装：

   node -v
   npm -v

安装Python和pip（部分工具需要）

一些以太坊开发工具可能依赖于Python。

1. 安装Python和pip：

   sudo apt install -y python3 python3-pip

2. 验证安装：

   python3 --version
   pip3 --version

安装Truffle（智能合约开发框架）

Truffle是一个流行的开发框架,用于在以太坊上构建去中心化应用（DApps），它内置了智能合约编译、测试、部署等一套完整的工作流。

1. 通过npm全局安装Truffle：

   sudo npm install -g truffle

2. 验证安装：

   truffle version

安装MetaMask（浏览器钱包插件）

MetaMask是一个浏览器扩展和应用程序钱包,让你能够管理自己的以太坊私钥，并与去中心化应用（DApps）进行交互。

1. 安装：
   • 在Chrome、Firefox、Edge等浏览器的扩展商店中搜索“MetaMask”。
   • 点击“添加到浏览器”并按照提示完成安装和设置。
   • 务必安全地记录你的助记词（Seed Phrase），这是你恢复钱包的唯一方式！

创建第一个以太坊项目并测试

现在我们已经搭建好了基本环境,可以创建一个简单的项目来测试。

1. 创建项目目录：

   mkdir my-eth-project
   cd my-eth-project

2. 初始化Truffle项目：

   truffle init

   这会生成一些基本目录结构,如contracts/（存放智能合约）、migrations/（部署脚本）、test/（测试文件）等。

3. 编写一个简单智能合约（可选）： 打开contracts/目录下的Migrations.sol文件，或者创建一个新的合约文件，例如SimpleStorage.sol：

   // SPDX-License-Identifier: MIT
   pragma solidity ^0.8.0;
   contract SimpleStorage {
       uint256 private storedData;
       function set(uint256 x) public {
           storedData = x;
       }
       function get() public view returns (uint256) {
           return storedData;
       }
   }

4. 编译合约：

   truffle compile

5. 启动本地开发节点（使用Geth或Ganache）：

   • 使用Geth启动私有链： 在项目目录下打开一个新的终端窗口，运行：

     geth --dev --http --http.addr "0.0.0.0" --http.port "8545" --http.api "personal,eth,net,web3"

     这会启动一个开发模式的以太坊节点,并监听8545端口。--dev标志会自动生成一些测试账户并预置大量以太币。

   • 使用Ganache（图形化私有链，推荐新手）：
     • 下载Ganache：https://trufflesuite.com/ganache/
     • 安装并打开Ganache,选择"QUICKSTART"，它会自动创建一个私有链并提供10个测试账户，每个账户有100个ETH。

6. 配置Truffle连接到节点： 打开项目根目录下的truffle-config.js（或truffle.js），确保有如下配置（以Ganache为例，端口需与Ganache一致）：

   module.exports = {
     networks: {
       development: {
         host: "127.0.0.1",     // Localhost (default: none)
         port: 7545,            // Standard Ethereum port (default: none)
         network_id: "*",       // Any network (default: none)
       },
       // 如果是geth --dev启动的私有链，端口可能是8545
       // geth_dev: {
       //   host: "127.0.0.1",
       //   port: 8545,
       //   network_id: "*",
       // }
     },
     compilers: {
       solc: {
         version: "0.8.0",    // 指定Solidity编译器版本，与合约中一致
       }
     }
   };

7. 编写部署脚本： 在migrations/目录下，创建一个新的迁移脚本，例如2_deploy_contracts.js：

   const SimpleStorage = artifacts.require("SimpleStorage");
   module.exports = function (deployer) {
     deployer.deploy(SimpleStorage);
   };

8. 部署合约： 确保开发节点正在运行，然后在项目终端执行：

   truffle migrate --network development

   成功部署后,你会在终端看到合约的地址等信息。

9. 与合约交互（通过Truffle Console或Web3.js）：

   • Truffle Console：

     truffle console --network development

     在控制台中输入：

     let instance = await SimpleStorage.deployed();
     await instance.set(42);
     let value = await instance.get();
     console.log(value.toString()); // 应该输出42

   • 通过MetaMask和DApp前端：这需要进一步编写前端代码，并配置Web3.js连接到MetaMask和你的私有链节点。

常见问题与注意事项

1. 端口占用：确保Geth或Ganache使用的端口没有被其他程序占用。
2. 网络ID不匹配：truffle migrate时确保truffle-config.js中配置的network_id与你的私有链网络ID一致。
3. Gas Limit与Gas Price：在私有链中，Gas限制和价格可以设置得较低，在Ganache中可以自由调整。
4. 同步节点：如果要连接到以太坊主网或测试网，需要使用Geth的sync参数，并确保有足够的磁盘空间和带宽，同步主网可能需要很长时间。
5. 安全性：开发环境中的私钥和助记词不要泄露到生产环境，MetaMask的助记词一定要安全备份。

通过以上步骤,你已经在Ubuntu系统上成功搭建了一个包括Geth、Node.js、Truffle和MetaMask在内的完整以太坊开发环境，现在你可以开始编写、测试和部署自己的智能合约