在区块链应用开发中，与以太坊网络的交互是核心环节，Web3.js 是以太坊官方提供的 JavaScript API 库，它让开发者能够通过浏览器或 Node.js 环境与以太坊节点通信，实现账户查询、交易发送、智能合约交互等功能，本文将详细介绍如何使用 Web3.js 连接以太坊节点，涵盖环境准备、连接方式、代码示例及常见问题解决，助你快速上手 Web3.js 开发。
在连接以太坊节点之前，首先需要安装 Web3.js 库，根据开发环境的不同,安装方式略有差异：
如果在前端项目中使用 Web3.js，可通过 CDN 直接引入最新版本，在 HTML 文件的 <head>
<body> 标签中添加以下代码：
<script src="https://cdn.jsdelivr.net/npm/web3@4.10.0/dist/web3.min.js"></script>
引入后，全局对象 window 上会挂载 Web3 实例，可直接通过 window.Web3 使用。
如果是后端（Node.js）项目，或需要更灵活的模块化管理，可通过 npm 安装：
npm install web3
安装完成后，在代码中通过 require 或 import 引入：
const Web3 = require('web3'); // CommonJS 方式
// 或
import Web3 from 'web3'; // ES Module 方式
以太坊节点是区块链网络的数据中转站，开发者需要通过 RPC（Remote Procedure Call）端点与节点通信，Web3.js 支持多种连接方式,以下是常见场景的实践方法。
如果你在本地运行了以太坊节点（如通过 Geth 或 Parity 启动），可直接通过本地 RPC 端点连接。
以 Geth 为例，启动一个同步以太坊主网的节点（默认 RPC 端口为 8545）：
geth --http --http.addr "0.0.0.0" --http.port "8545" --http.corsdomain "*"
--http：启用 HTTP-RPC 服务 --http.addr "0.0.0.0"：允许任何 IP 访问（开发环境可用，生产环境需限制） --http.corsdomain "*"：允许跨域请求（前端开发时需配置） const Web3 = require('web3');
// 创建 Web3 实例，传入节点 RPC 地址
const web3 = new Web3('http://localhost:8545');
// 验证连接是否成功
web3.eth.getBlockNumber().then(console.log).catch(console.error);
如果连接成功，控制台会输出当前以太坊网络的最新区块号（如 19000000 左右，具体取决于同步进度）。
本地节点同步速度慢且需要高性能设备，开发时更推荐使用第三方远程节点服务（如 Infura、Alchemy），它们提供稳定的 RPC 端点，无需同步全量数据,适合快速开发。
以 Infura 为例：
https://<网络名称>.infura.io/v3/<项目 ID>。 https://mainnet.infura.io/v3/YOUR_PROJECT_ID https://ropsten.infura.io/v3/YOUR_PROJECT_ID const Web3 = require('web3');
// 使用 Infura RPC 端点
const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_PROJECT_ID');
// 验证连接
web3.eth.getBalance('0x742d35Cc6634C0532925a3b844Bc9e7595f8bE8c').then(console.log);
上述代码会查询指定地址的以太坊余额（单位是 wei），可通过 web3.utils.fromWei() 转换为 ETH：
web3.eth.getBalance('0x742d35Cc6634C0532925a3b844Bc9e7595f8bE8c').then(balance => {
console.log(`Balance: ${web3.utils.fromWei(balance, 'ETH')} ETH`);
});
MetaMask 是主流的浏览器钱包插件，它会在用户浏览器中注入 ethereum 对象，可通过该对象获取节点 RPC 地址。
if (typeof window.ethereum !== 'undefined') {
console.log('MetaMask is installed!');
} else {
console.log('MetaMask is not installed. Please install it.');
}
const Web3 = require('web3');
// 使用 MetaMask 提供的 RPC
const web3 = new Web3(window.ethereum);
// 请求用户授权连接账户
async function connectAccount() {
try {
const accounts = await window.ethereum.request({ method: 'eth_requestAccounts' });
console.log('Connected account:', accounts[0]);
return accounts[0];
} catch (error) {
console.error('User denied account access:', error);
}
}
// 调用连接函数
connectAccount();
注意：MetaMask 仅支持 HTTPS 协议或 localhost，且用户需手动授权连接账户，符合 Web3 钱包的安全机制。
HTTP-RPC 是请求-响应模式，适合查询类操作；但如果需要实时监听链上事件（如新区块、交易确认），WebSocket 协议更高效（长连接，避免重复请求）。
以 Geth 为例，启动时添加 --ws 参数：
geth --ws --ws.addr "0.0.0.0" --ws.port "8546" --ws.origins "*"
const Web3 = require('web3');
// 创建 WebSocket 提供者
const web3 = new Web3('ws://localhost:8546');
// 监听新区块事件
web3.eth.subscribe('newBlocks', (error, block) => {
if (error) console.error(error);
console.log('New block received:', block.number);
}).on('connected', (subscriptionId) => {
console.log('Subscription ID:', subscriptionId);
});
连接节点后,可通过以下代码验证功能是否正常：
// 获取当前链 ID（主网为 1，Ropsten 测试网为 3） web3.eth.getChainId().then(console.log); // 获取当前节点同步状态 web3.eth.getBlockNumber().then(console.log);
// 查询节点管理的账户列表（需本地节点解锁）
web3.eth.getAccounts().then(console.log);
// 查询指定地址的余额
const address = '0x742d35Cc6634C0532925a3b844Bc9e7595f8bE8c';
web3.eth.getBalance(address).then(balance => {
console.log(`${web3.utils.toChecksumAddress(address)} 的余额: ${web3.utils.fromWei(balance, 'ETH')} ETH`);
});
发送交易需要私钥签名，建议使用 web3.eth.accounts.signTransaction 安全处理：
const senderPrivateKey = 'YOUR_PRIVATE_KEY'; // 替换为实际私钥（开发环境勿泄露）
const senderAddress = '0xYourSenderAddress';
const receiverAddress = '0xReceiverAddress';
const amount = web3.utils.toWei('0.01', 'ETH'); // 0.01 ETH
// 构建交易对象
const transaction = {
to: receiverAddress,
value: amount,
gas: 21000