以太坊Windows开发环境搭建完整教程，从零开始构建你的区块链开发工作台

环境搭建前的准备工作

在开始之前,请确保你的系统满足以下要求：

• 操作系统：Windows 10/11（64位）
• 硬盘空间：至少10GB可用空间
• 网络：稳定的网络连接（需要下载相关工具）

我们需要安装的核心组件包括：

1. Node.js（JavaScript运行时环境）
2. Git（版本控制工具）
3. Visual Studio Code（代码编辑器）
4. Ganache（本地区块链测试网络）
5. Truffle 或 Hardhat（开发框架）
6. MetaMask（以太坊钱包浏览器插件）

---

安装 Node.js

Node.js 是以太坊开发的基础，Truffle、Hardhat 等工具都依赖它。

1 下载安装

1. 访问官网：https://nodejs.org
2. 选择 LTS（长期支持版），建议版本 18.x 或以上
3. 下载 .msi 安装包，双击运行
4. 安装时保持默认选项即可,注意勾选 "Add to PATH"

2 验证安装

打开命令提示符（按 Win + R，输入 cmd），执行以下命令：

node -v
npm -v

如果正确显示版本号,说明安装成功：

v18.19.0
10.2.4

3 配置国内镜像源（可选但推荐）

由于网络原因,建议切换为国内镜像加速下载：

npm config set registry https://registry.npmmirror.com

---

安装 Git

Git 用于代码版本管理，也是后续一些工具安装的依赖。

1. 访问 https://git-scm.com/download/win 下载安装包
2. 安装过程中保持默认设置即可
3. 验证安装：

git --version

---

安装 Visual Studio Code 及插件

1 安装 VS Code

从官网 https://code.visualstudio.com 下载并安装。

2 安装必备插件

打开 VS Code，进入扩展商店（Ctrl + Shift + X），搜索并安装：

• Solidity（by Juan Blanco）—— 智能合约语法高亮与编译
• Prettier，代码格式化工具
• ESLint，JavaScript 代码检查

安装 Solidity 插件后，在设置中将编译器版本设置为与项目匹配的版本（如 8.19）。

---

安装 Ganache 本地测试链

Ganache 是一个运行在本地的个人以太坊区块链，预置了10个测试账户，每个账户有100 ETH，非常适合开发和调试。

1 下载安装

1. 访问 https://trufflesuite.com/ganache/
2. 下载 Windows 版 Ganache-setup-2.x.x.exe
3. 安装并启动

2 快速验证

启动 Ganache 后，你会看到如下界面：

• RPC 地址：HTTP://127.0.0.1:7545
• 网络ID：5777（默认）
• 10个测试账户：含地址和私钥

💡 提示：Ganache UI 已停止维护，也可以选择使用命令行版本 ganache：npm install -g ganache，然后运行 ganache 即可（默认端口 8545）。

---

安装开发框架（Truffle 或 Hardhat）

1 方案一：Truffle

全局安装 Truffle：

npm install -g truffle

验证安装：

truffle version

2 方案二：Hardhat（推荐）

Hardhat 是目前更主流的选择，社区活跃度更高：

mkdir my-dapp
cd my-dapp
npm init -y
npm install --save-dev hardhat
npx hardhat init

按照提示选择 "Create a JavaScript project"，Hardhat 会自动生成项目骨架。

---

安装 MetaMask 钱包

MetaMask 用于与本地测试链交互：

1. 在 Chrome / Edge 浏览器中访问 https://metamask.io

2. 安装浏览器插件并创建钱包

3. 连接本地网络：点击顶部网络选择器 → Add Network → 手动填写：

   • 网络名称：Ganache
   • RPC URL：http://127.0.0.1:7545
   • 链ID：5777（以 Ganache 显示为准）
   • 货币符号：ETH

4. 导入测试账户：在 Ganache 中点击某个账户的钥匙图标，复制私钥，在 MetaMask 中选择“导入账户”粘贴即可。

---

编写并部署第一个智能合约

以 Hardhat 为例，创建一个简单的存储合约。

1 编写合约

在 contracts 目录下创建 SimpleStorage.sol：

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

2 编译合约

npx hardhat compile

3 编写部署脚本

在 scripts 目录下创建 deploy.js：

const hre = require("hardhat");
async function main() {
    const SimpleStorage = await hre.ethers.getContractFactory("SimpleStorage");
    const contract = await SimpleStorage.deploy();
    await contract.waitForDeployment();
    console.log("合约已部署至地址:", await contract.getAddress());
}
main().catch((error) => {
    console.error(error);
    process.exitCode = 1;
});

4 启动本地节点并部署

新开一个终端,启动本地区块链节点：

npx hardhat node

在原终端执行部署（默认连接 Hardhat 网络）：

npx hardhat run scripts/deploy.js --network localhost

看到输出的合约地址,恭喜你——环境搭建成功！🎉

---

常见问题与解决方案

问题	解决方案
npm 命令无法识别	重启电脑，或检查环境变量 Path 是否包含 Node.js 路径
合约编译报版本错误	修改 pragma solidity 版本，或安装指定版本编译器
Hardhat 连不上本地节点	确认 hardhat.config.js 中网络配置的 URL 和端口正确
MetaMask 交易pending	检查链ID是否与 Ganache/Hardhat 节点一致
npm 安装速度慢	切换国内镜像源，或使用代理

---

至此,一套完整的以太坊 Windows 开发环境就搭建完成了，回顾一下整个流程：

**Node.js → Git → VS Code