Web3作为下一代互联网的核心技术，正推动着去中心化应用（DApp）的蓬勃发展，而Web3库作为连接区块链与前端应用的桥梁，其安装与配置是开发者入门的第一步，本文将以最主流

的以太坊生态为例,详细介绍Web3库的安装流程及注意事项。

选择合适的Web3库

Web3生态中有多个主流库，开发者需根据项目需求选择：

• web3.js：以太坊官方维护的JavaScript库，功能全面，支持以太坊主网及测试网交互，适合需要完整区块链功能的项目。
• ethers.js：轻量级库，API设计更现代化，文档友好，适合注重开发效率和代码简洁性的场景。
• viem：新兴库，以高性能和TypeScript原生支持为特色，逐渐成为开发者的新选择。

本文以web3.js（最经典）和ethers.js（更流行）为例展开说明。

环境准备：安装Node.js与npm

无论选择哪个库，首先需确保本地开发环境已安装Node.js（建议LTS版本，如v18.x以上）和npm（Node包管理器），打开终端，输入以下命令验证安装：

node -v  # 查看Node.js版本
npm -v   # 查看npm版本

若未安装，可前往Node.js官网下载对应系统的安装包,安装后重启终端即可。

安装Web3库

使用npm安装（推荐）

在项目根目录下打开终端，通过npm安装对应库：

安装web3.js

npm install web3

安装完成后，在代码中引入：

const Web3 = require('web3'); // CommonJS方式
// 或 ES6方式：import Web3 from 'web3';

安装ethers.js

npm install ethers

引入方式：

const { ethers } = require('ethers'); // CommonJS方式
// 或 ES6方式：import { ethers } from 'ethers';

使用CDN安装（前端项目快速集成）

若仅需在前端页面中临时使用，可通过CDN直接引入，无需npm安装：

web3.js的CDN引入

<script src="https://cdn.jsdelivr.net/npm/web3@4.8.0/dist/web3.min.js"></script>

使用时，Web3对象会直接挂载在全局：

const web3 = new Web3(Web3.givenProvider || "http://localhost:8545");

ethers.js的CDN引入

<script src="https://cdn.jsdelivr.net/npm/ethers@6.8.1/dist/ethers.umd.min.js"></script>

使用时，通过全局ethers对象调用：

const provider = new ethers.providers.Web3Provider(window.ethereum);

验证安装与基础配置

安装完成后，可通过简单代码验证库是否正常工作，以web3.js为例，连接到以太坊测试网（如Goerli）：

const Web3 = require('web3');
const web3 = new Web3('https://goerli.infura.io/v3/YOUR_INFURA_PROJECT_ID'); // 替换为你的Infura项目ID
web3.eth.getBlockNumber().then(console.log).catch(console.error);

若成功返回区块号，说明安装配置正确，对于ethers.js，类似验证代码为：

const { ethers } = require('ethers');
const provider = new ethers.providers.JsonRpcProvider('https://goerli.infura.io/v3/YOUR_INFURA_PROJECT_ID');
provider.getBlockNumber().then(console.log);

常见问题与注意事项

1. 版本兼容性：注意Web3库与Node.js版本的兼容性，建议在package.json中锁定依赖版本，避免因版本更新导致API变更。
2. Provider配置：DApp开发中，需优先使用浏览器内置的window.ethereum（如MetaMask）作为Provider，以支持用户账户交互，

   const web3 = new Web3(window.ethereum); // web3.js
   const provider = new ethers.BrowserProvider(window.ethereum); // ethers.js

3. 网络选择：连接测试网时，需确保节点服务可用（如Infura、Alchemy等免费节点服务），或本地运行Ganache等开发工具。

安装Web3库是开发DApp的基础步骤，通过npm或CDN均可快速完成，开发者可根据项目需求选择web3.js、ethers.js或viem等库，并结合Provider配置实现与区块链网络的交互，掌握基础安装流程后，后续可深入学习合约部署、交易签名等进阶功能,逐步构建完整的去中心化应用。