• Solidity：以太坊智能合约的核心编程语言，需安装编译器（solc）。
• JavaScript/TypeScript：DApp前端交互的主要语言，Node.js 是必备基础。
• Python（可选）：部分开发工具（如Web3.py）支持Python开发，适合后端集成。

核心工具

• 以太坊客户端：实现节点通信、交易广播等功能，常用选择包括：
  • Geth：Go语言开发的官方客户端，功能全面，适合搭建完整节点。
  • Nethermind：.NET Core客户端，性能优越，支持Windows/macOS/Linux。
  • Infura（第三方服务）：无需本地节点，通过API连接以太坊网络，适合快速开发测试。
• 开发框架：简化DApp开发流程，如Truffle、Hardhat（推荐新手使用，提供热重载、测试框架等内置功能）。

系统要求

• 操作系统：Windows 10+、macOS 10.15+、Ubuntu 18.04+（Linux推荐Ubuntu，兼容性更好）。
• 硬件：至少8GB内存（建议16GB），SSD硬盘（节点同步需大量存储空间，目前主网需数TB）。
• 网络：稳定的互联网连接（节点同步时需长时间在线）。

详细安装步骤：从环境配置到节点启动

基础环境安装：Node.js 与 Python

（1）安装Node.js（JavaScript运行环境）

Node.js是运行Truffle、Hardhat等框架的基础，建议安装LTS（长期支持）版本。

• Windows/macOS：访问 Node.js官网 下载安装包，双击安装即可（自动配置环境变量）。
• Ubuntu：

  sudo apt update
  sudo apt install nodejs npm  # npm为Node包管理器

• 验证安装：打开终端/命令行，输入 node -v 和 npm -v，显示版本号则安装成功。

（2）安装Python（可选）

若使用Python开发,需安装Python 3.8+及pip（包管理器）：

• Windows/macOS：从 Python官网 下载安装包，勾选“Add Python to PATH”。
• Ubuntu：

  sudo apt install python3 python3-pip

以太坊客户端安装：选择Geth或Nethermind

（1）安装Geth（Go-Ethereum）

Geth是使用最广的以太坊客户端,支持全节点、轻节点及开发模式。

• Windows：

  1. 访问 Geth官方发布页，下载Windows 64位安装包（.zip格式）。
  2. 解压到固定目录（如C:\geth），将目录添加到系统环境变量Path中（方便全局调用）。

• macOS（使用Homebrew包管理器）：

  brew install geth

• Ubuntu：

  sudo apt install software-properties-common
  sudo add-apt-repository -y ppa:ethereum/ethereum
  sudo apt update
  sudo apt install geth

• 验证安装：终端输入 geth version，显示版本信息即成功。

（2）安装Nethermind（.NET客户端）

Nethermind性能优异,适合Windows开发者，支持POS共识（无需大量存储同步）。

• Windows：

  1. 访问 Nethermind GitHub Releases，下载最新nethermind-x.x.x-windows-amd64.zip。
  2. 解压到目录（如D:\Nethermind），双击Nethermind.Runner.exe即可启动默认节点。

• macOS/Linux：
  使用.NET SDK安装：

  dotnet tool install -g Nethermind.Runner
  nethermind --config mainnet  # 主网配置

开发框架安装：Hardhat（推荐新手）

Hardhat是现代以太坊开发框架,内置编译、测试、调试工具，支持Solidity和TypeScript。

• 安装步骤：
  1. 创建项目目录：

     mkdir eth-project && cd eth-project

  2. 初始化npm项目（默认配置）：

     npm init -y

  3. 安装Hardhat：

     npm install --save-dev hardhat

  4. 初始化项目结构：

     npx hardhat

     按提示选择“Create a basic sample project”，生成contracts/（智能合约）、scripts/（部署脚本）、test/（测试用例）等目录。

智能合约编译器配置：Solc

Hardhat会自动安装solc（Solidity编译器），但需确保版本与合约兼容。

• 检查solc版本：

  npx hardhat compile

  若提示版本不匹配,可通过npm install --save-dev @nomicfoundation/solidity-json-parser手动指定版本。

启动私有测试节点（开发必备）

为了避免消耗真实ETH,建议先搭建本地私有测试网络。

使用Geth启动私有节点

1. 初始化创世区块：

   geth --datadir "./data" init ./genesis.json  # 需提前准备genesis.json（创世配置文件）

   genesis.json示例（测试用简单配置）：

   {
     "config": {
       "chainId": 1337,
       "homesteadBlock": 0,
       "eip150Block": 0,
       "eip155Block": 0,
       "eip158Block": 0
     },
     "alloc": {},
     "coinbase": "0x0000000000000000000000000000000000000000",
     "difficulty": "0x20000",
     "gasLimit": "0x2fefd8",
     "nonce": "0x0000000000000042",
     "timestamp": "0x0"
   }

2. 启动私有节点：

   geth --datadir "./data" --http --http.addr "0.0.0.0" --http.port "8545" --http.api "eth,net,web3" --dev

   参数说明：

   • --datadir：节点数据存储目录。
   • --http：开启HTTP API服务（默认端口8545）。
   • --dev：开发模式，自动分配测试ETH，出块速度加快。

3. 验证节点：
   另开终端，输入 geth attach http://localhost:8545，进入控制台后执行 eth.blockNumber，返回区块号则启动成功。

常见问题与解决方案

节点同步缓慢

• 问题：连接主网时，Geth/Nethermind同步区块速度过慢。
• 解决：
  • 使用快照同步（Geth：geth --syncmode snap；Nethermind：SyncMode.Snap），减少数据下载量。
  • 选择Infura等第三方服务，无需本地同步，直接通过API访问（注册Infura获取免费API密钥）。

端口占用

• 问题：启动节点时报错“Address already in use: [::]:8545”。
• 解决：修改端口（如--http.port "8546"），或通过netstat -ano | findstr 8545查找占用进程并关闭。

solc版本不兼容

• 问题：编译合约时报错“Version pragma^ expects a different compiler version”。
• 解决：在