Web3.js以太坊DApp开发完全指南,从零构建你的第一个去中心化应用
随着区块链技术的快速发展,去中心化应用(DApp)已经成为Web3时代的核心产物,而在以太坊DApp开发中,Web3.js无疑是最重要的工具库之一,本文将系统性地介绍如何使用Web3.js进行以太坊DApp开发,帮助你快速入门并掌握实战技能。
什么是DApp和Web3.js?
1 DApp简介
DApp(Decentralized Application,去中心化应用)是运行在区块链网络上的应用程序,与传统App相比,DApp具有以下特点:
- 去中心化:数据存储在区块链上,不依赖单一服务器
- 不可篡改:一旦部署,合约逻辑无法随意修改
- 透明公开:所有交易记录可查可验证
- 代币激励:通常内置通证经济模型
2 Web3.js是什么?
Web3.js是以太坊官方提供的JavaScript API库,它允许开发者通过HTTP、IPC或WebSocket与以太坊节点进行通信,Web3.js就是前端页面与区块链之间的“桥梁”。
开发环境准备
1 安装基础工具
在开始之前,你需要准备以下开发环境:
# 安装Node.js(建议16以上版本) node -v # 创建项目目录 mkdir my-first-dapp cd my-first-dapp npm init -y # 安装web3.js npm install web3
2 安装MetaMask钱包
MetaMask是开发DApp必备的浏览器插件钱包,它提供:
- 以太坊账户管理
- 测试网ETH获取
- 与DApp的交互界面
- 交易签名功能
3 搭建本地测试链
推荐使用Ganache搭建本地测试网络:
npm install -g ganache ganache
启动后你会看到10个预置账户,每个账户有100 ETH测试币。
Web3.js核心功能实战
1 初始化Web3实例
这是所有DApp开发的第一步——连接以太坊网络:
const Web3 = require('web3');
// 方式一:连接Ganache本地网络
const web3 = new Web3('http://127.0.0.1:7545');
// 方式二:通过浏览器钱包连接(推荐)
async function initWeb3() {
if (typeof window.ethereum !== 'undefined') {
try {
// 请求用户授权连接钱包
await window.ethereum.request({
method: 'eth_requestAccounts'
});
const web3 = new Web3(window.ethereum);
console.log('钱包连接成功');
return web3;
} catch (error) {
console.error('用户拒绝了连接请求');
}
} else {
alert('请先安装MetaMask钱包');
}
}
2 获取账户信息
async function getAccountInfo() {
// 获取当前账户
const accounts = await web3.eth.getAccounts();
console.log('当前账户:', accounts[0]);
// 查询账户余额
const balance = await web3.eth.getBalance(accounts[0]);
console.log('余额:', web3.utils.fromWei(balance, 'ether'), 'ETH');
// 获取当前区块高度
const blockNumber = await web3.eth.getBlockNumber();
console.log('当前区块:', blockNumber);
}
3 发送以太坊转账交易
async function sendTransaction() {
const accounts = await web3.eth.getAccounts();
const tx = {
from: accounts[0],
to: '0x目标地址',
value: web3.utils.toWei('0.1', 'ether'), // 转换为wei单位
gas: 21000
};
// 签名并发送交易
const receipt = await web3.eth.sendTransaction(tx);
console.log('交易哈希:', receipt.transactionHash);
}
与智能合约交互
1 编写并部署智能合约
先写一个简单的存储合约(Remix IDE中编译部署):
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
contract SimpleStorage {
uint256 private storedData;
event DataStored(uint256 newValue);
function set(uint256 x) public {
storedData = x;
emit DataStored(x);
}
function get() public view returns (uint256) {
return storedData;
}
}
2 在前端调用合约
// 合ABI和地址(部署后获得)
const contractABI = [...]; // 从Remix编译结果复制
const contractAddress = '0x你的合约地址';
// 创建合约实例
const contract = new web3.eth.Contract(contractABI, contractAddress);
// 读取数据(view函数,无需支付Gas)
async function readData() {
const value = await contract.methods.get().call();
console.log('存储的值:', value);
}
// 写入数据(需要支付Gas)
async function writeData(newValue) {
const accounts = await web3.eth.getAccounts();
await contract.methods.set(newValue).send({
from: accounts[0]
})
.on('transactionHash', (hash) => {
console.log('交易已提交:', hash);
})
.on('confirmation', (confirmationNumber) => {
console.log('确认数:', confirmationNumber);
})
.on('error', (error) => {
console.error('交易失败:', error);
});
}
3 监听合约事件
// 监听数据存储事件
contract.events.DataStored({
fromBlock: 0
}, (error, event) => {
if (!error) {
console.log('捕获到新事件:', event.returnValues.newValue);
}
});
完整DApp前端示例
将上述功能整合成一个简单页面:
<!DOCTYPE html>
<html>
<head>我的第一个DApp</title>
</head>
<body>
<button id="connectBtn">连接钱包</button>
<p id="account"></p>
<input id="dataInput" type="number" placeholder="输入数值" />
<button id="setBtn">存储数据</button>
<button id="getBtn">读取数据</button>
<p id="result"></p>
<script src="https://cdn.jsdelivr.net/npm/web3@latest/dist/web3.min.js"></script>
<script>
let web3, contract, account;
const contractABI = [...];
const contractAddress = '0x...';
document.getElementById('connectBtn').onclick = async () => {
await window.ethereum.request({
method: 'eth_requestAccounts'
});
web3 = new Web3(window.ethereum);
const accounts = await web3.eth.getAccounts();
account = accounts[0];
contract = new web3.eth.Contract(contractABI, contractAddress);
document.getElementById('account').innerText =
'当前账户:' + account;
};
document.getElementById('setBtn').onclick = async () => {
const value = document.getElementById('dataInput').value;
await contract.methods.set(value).send({ from: account });
The End
发布于:2026-10-30,除非注明,否则均为原创文章,转载请注明出处。

