跳转到内容

开发环境搭建

开发环境搭建

本页内容正在整理中,欢迎贡献

概述

在开始以太坊开发之前,你需要搭建一套完整的本地开发环境。本文将引导你安装所有必要工具:Node.js 运行时、智能合约开发框架(Hardhat 或 Foundry)以及浏览器钱包 MetaMask。

主要内容

1. 安装 Node.js

推荐使用 nvm(Node Version Manager)管理 Node.js 版本:

Terminal window
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 安装并使用 LTS 版本
nvm install --lts
nvm use --lts
# 验证安装
node --version # 应输出 v20.x.x 或更高
npm --version

2. 选择开发框架

框架语言优势适合人群
HardhatJavaScript/TypeScript生态丰富、插件多、调试友好JS/TS 开发者
FoundrySolidity/Rust编译快、测试用 Solidity 写、Gas 报告精准性能优先、纯合约开发者

安装 Hardhat

Terminal window
mkdir my-dapp && cd my-dapp
npm init -y
npm install --save-dev hardhat
npx hardhat init
# 选择 "Create a TypeScript project"

安装 Foundry

Terminal window
# 安装 foundryup
curl -L https://foundry.paradigm.xyz | bash
source ~/.bashrc # 或 source ~/.zshrc
# 安装最新版 Foundry 工具链
foundryup
# 验证
forge --version
cast --version
anvil --version
# 创建新项目
forge init my-project

3. 安装 MetaMask

  1. 访问 metamask.io 安装浏览器扩展
  2. 创建新钱包并安全保存助记词(离线存储)
  3. 添加 Sepolia 测试网:
    • 网络名称:Sepolia
    • RPC URL:https://sepolia.infura.io/v3/YOUR_KEY 或使用 Chainlist
    • 链 ID:11155111
    • 货币符号:ETH

4. 获取测试网 ETH

详见 测试网水龙头 页面。

5. 配置编辑器

推荐使用 VS Code 并安装以下插件:

  • Solidity (Nomic Foundation) —— 语法高亮、错误提示
  • Hardhat for Visual Studio Code —— Hardhat 集成
  • Even Better TOML —— Foundry 配置文件支持

6. 环境变量管理

Terminal window
# 安装 dotenv(Hardhat 项目)
npm install dotenv
# 创建 .env 文件(不要提交到 git!)
echo "PRIVATE_KEY=0x..." > .env
echo "SEPOLIA_RPC_URL=https://..." >> .env
echo ".env" >> .gitignore

验证环境

完成安装后,运行以下命令验证环境是否正常:

Terminal window
# Hardhat
npx hardhat compile
npx hardhat test
# Foundry
forge build
forge test

下一步

环境搭建完成后,前往 第一个 Solidity 合约 开始编写你的第一个智能合约。