使用 Node.js 和 npm 安装 Web3.js,以太坊区块链交互指南

admin 发布于 2026-04-15 23:45 频道：默认分类阅读：55

Web3.js 是一个强大的 JavaScript 库，它允许开发者与以太坊区块链进行交互，通过结合 Node.js 的后端能力和 npm 的包管理功能，我们可以轻松构建与区块链通信的应用程序，本文将详细介绍如何在 Node.js 环境中使用 npm 安装 Web3.js，并展示一些基本用法。

环境准备

在开始之前,请确保你的系统已经安装了以下工具：

Node.js 和 npm：访问 Node.js 官网下载并安装 LTS 版本，安装完成后 npm 会自动包含。
验证安装：打开终端或命令提示符，运行以下命令检查版本：
```
node -v
npm -v
```

安装 Web3.js

创建项目目录

创建一个新的项目目录并进入：

mkdir my-web3-project
cd my-web3-project

初始化 npm 项目

在项目目录中初始化 npm 项目（使用 -y 参数接受默认设置）：

npm init -y

这会创建一个 package.json 文件，用于管理项目依赖。

安装 Web3.js

使用 npm 安装 Web3.js：

npm install web3

安装完成后,你会在 node_modules 目录中看到 Web3.js 的文件，并且在 package.json 的 dependencies 中会添加 Web3.js 的依赖信息。

使用 Web3.js

安装完成后,你可以在 Node.js 项目中引入并使用 Web3.js，以下是一个简单的示例，展示如何连接到以太坊网络并获取最新区块号：

创建示例文件

在项目目录中创建一个 app.js 文件：

const Web3 = require('web3');
// 连接到以太坊节点（这里使用 Infura 的公共节点）
const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID');
// 获取最新区块号
web3.eth.getBlockNumber()
    .then(console.log)
    .catch(console.error);

获取 Infura 项目 ID

要使用上面的代码,你需要：

访问 Infura 官网并创建一个新项目。
在项目中获取你的 Project ID，替换代码中的 YOUR_INFURA_PROJECT_ID。

运行示例

在终端中运行：

>node app.js

如果连接成功,你将看到最新的以太坊区块号。

进阶用法

连接到本地节点

如果你运行了一个本地以太坊节点（如 Geth 或 Parity），可以这样连接：

const web3 = new Web3('http://localhost:8545');

检查网络连接

web3.eth.net.isListening()
    .then(() => console.log('Connected to Ethereum network'))
    .catch(e => console.error('Failed to connect:', e));

获取账户余额

const address = '0x742d35Cc6634C0532925a3b844Bc9e7595f8e0a8'; // 替换为实际地址
web3.eth.getBalance(address)
    .then(balance => console.log(`Balance: ${web3.utils.fromWei(balance, 'ether')} ETH`));

注意事项

安全性：不要将私钥或敏感信息硬编码在代码中，使用环境变量管理敏感信息。
错误处理：区块链操作可能失败，始终使用 try-catch 或 Promise 的 catch 方法处理错误。
版本选择：Web3.js 有多个版本，目前最新的是 1.x 版本，与旧版本（0.x）有较大差异，注意查阅对应文档。
网络选择：根据你的需求选择合适的以太坊网络（主网、测试网或本地网络）。

通过以上步骤,你已经成功在 Node.js 项目中安装并配置了 Web3.js，可以开始构建与以太坊区块链交互的应用程序了，Web3.js 提供了丰富的 API，用于读取区块链数据、发送交易、与智能合约交互等，随着对 Web3.js 的深入了解，你将能够开发出更加复杂的去中心化应用（DApps）。

继续探索 Web3.js 的官方文档，尝试更多功能，开启你的区块链开发之旅吧！