用Node.js快速入门Web3.js：从零开始玩转以太坊

用Node.js快速入门Web3.js：从零开始玩转以太坊2026-05-17 06:51:26

关于Web3.js，你要知道些什么

嘿，朋友！如果你对区块链感兴趣，特别是以太坊，Web3.js 是一个你绝对不能错过的库。它能帮助我们与以太坊区块链进行交互。今天，我就带着你一起探索如何在Node.js环境中使用Web3.js，保证你能轻松上手！

安装Node.js与Web3.js

首先，你得确保你的电脑上已经安装了Node.js。没安装？那就赶紧去Node.js官网下载一个适合你系统的版本。

安装完成后，打开命令行工具，输入以下命令来安装Web3.js：

npm install web3

这就好了，Web3.js现在已经在你的Node.js项目中无缝集成了。

连接以太坊网络

安装完毕，接下来我们要做的就是连接到以太坊网络。Web3.js支持多个网络，比如主网、测试网和私有链。这里我以Rinkeby测试网为例，它是一个非常适合开发和测试的网络。

const Web3 = require('web3');
const web3 = new Web3('https://rinkeby.infura.io/v3/YOUR_INFURA_PROJECT_ID');

在上面的代码中，别忘了把YOUR_INFURA_PROJECT_ID替换成你自己的Infura项目ID。如果你还没有，就去Infura官网申请一个吧，简单得很。

获取区块链信息

成功连接后，我们可以尝试获取一些基本信息，比如当前的区块号或者某个地址的余额。想知道现在的区块号到底是什么？试试这段代码：

web3.eth.getBlockNumber()
  .then(blockNumber => {
    console.log('当前区块号:', blockNumber);
  });

嗯，这样你就能看到当前的区块号啦！如果你想查看某个以太坊地址的余额，代码也很简单：

const address = '0x...'; // 替换成你想查询的地址
web3.eth.getBalance(address)
  .then(balance => {
    console.log('余额:', web3.utils.fromWei(balance, 'ether'), 'ETH');
  });

这里的web3.utils.fromWei方法用于将余额从Wei转换为以太币，方便查看。

发送交易

看到这里，你可能在想，“我也想试试发送交易”，好吧，接下来我们就来看看如何实现。发送交易需要签名，这涉及到私钥的使用，务必小心哦！

const account = '0x...'; // 你的地址
const privateKey = 'YOUR_PRIVATE_KEY'; // 你的私钥
const recipient = '0x...'; // 接收者地址
const amount = web3.utils.toWei('0.1', 'ether'); // 要发送的金额（0.1 ETH）

const transaction = {
  to: recipient,
  value: amount,
  gas: 21000,
  gasPrice: web3.utils.toHex(web3.utils.toWei('20', 'gwei')),
  nonce: web3.eth.getTransactionCount(account)
};

const signAndSendTransaction = async () => {
  const signedTx = await web3.eth.accounts.signTransaction(transaction, privateKey);
  web3.eth.sendSignedTransaction(signedTx.rawTransaction)
    .then(receipt => {
      console.log('交易成功！哈希值:', receipt.transactionHash);
    })
    .catch(err => {
      console.error('交易失败:', err);
    });
};

signAndSendTransaction();

这个代码片段里，nonce的获取确保了每笔交易的唯一性，gas和gasPrice要根据当前网络情况来选择。记得在测试网进行实验，不要在主网乱发钱哦！

用Web3.js与智能合约交互

到这里，你已经学会了如何发送交易，接下来就可以和智能合约互动了。假设你有一个智能合约的ABI（应用程序二进制接口）和它的合约地址，你可以像这样创建合约对象：

const contractABI = [...]; // 替换为实际的合约ABI
const contractAddress = '0x...'; // 替换为实际的合约地址
const contract = new web3.eth.Contract(contractABI, contractAddress);

然后，你可以调用合约的方法，比如读取状态：

contract.methods.yourMethodName().call()
  .then(result => {
    console.log('结果:', result);
  });

这一过程真的很简单。只需要几个步骤，你就能从以太坊合约中提取数据了。

处理事务的事件

哦，几乎忘了说，Web3.js还支持监听合约事件。如果你的合约在某个操作后会发出事件，可以用以下方式来监听：

contract.events.YourEventName({
    filter: {value: 5}, // 可选的筛选条件
    fromBlock: 0
}, function (error, event) { 
    console.log('事件触发:', event);
});

这样一来，每次指定事件被触发时，你都能收到通知，真是太方便了。

错误处理与调试

在开发过程中，错误是难免的，尤其是与区块链进行交互时。有时候网络问题，有时候是因为你没钱，在测试网就好很多。务必保持冷静，认真查看错误信息。此外，Web3.js也提供了调试工具，你可以通过console.log一些关键变量，确认它们的状态。

结尾的小建议

使用Web3.js的过程里，就像是探索一个新世界。多动手，多实践，相信你一定能发现很多有趣的东西。我的经验是，持续关注以太坊的动态变化，多参与社区讨论，这样你才能更快地成长。

如果你在学习过程中遇到问题，可以随时发问，或者上GitHub、Stack Overflow等地方找寻答案。重要的是，不要放弃！

这就是我和你分享的关于用Node.js使用Web3.js的经验。一开始可能会有点迷茫，但慢慢来，你一定能掌握的！加油！