Web3.js以太坊DApp开发完全指南,从零构建你的第一个去中心化应用

博主:neragonerago 2026-10-30 23:52:04 24

随着区块链技术的快速发展,去中心化应用(DApp)已经成为Web3时代的核心产物,而在以太坊DApp开发中,Web3.js无疑是最重要的工具库之一,本文将系统性地介绍如何使用Web3.js进行以太坊DApp开发,帮助你快速入门并掌握实战技能。

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,除非注明,否则均为区块链社区- 欧亿APP下载原创文章,转载请注明出处。