Web3作为下一代互联网的核心技术，正推动着去中心化应用（DApp）的蓬勃发展，而Web3库作为连接区块链与前端应用的桥梁，其安装与配置是开发者入门的第一步，本文将以最主流的以太坊生态为例,详细介绍Web3库的安装流程及注意事项。
Web3生态中有多个主流库，开发者需根据项目需求选择：
本文以web3.js（最经典）和
无论选择哪个库，首先需确保本地开发环境已安装Node.js（建议LTS版本，如v18.x以上）和npm（Node包管理器），打开终端，输入以下命令验证安装：
node -v # 查看Node.js版本 npm -v # 查看npm版本
若未安装，可前往Node.js官网下载对应系统的安装包,安装后重启终端即可。
在项目根目录下打开终端，通过npm安装对应库：
npm install web3
安装完成后，在代码中引入：
const Web3 = require('web3'); // CommonJS方式
// 或 ES6方式：import Web3 from 'web3';
npm install ethers
引入方式：
const { ethers } = require('ethers'); // CommonJS方式
// 或 ES6方式：import { ethers } from 'ethers';
若仅需在前端页面中临时使用，可通过CDN直接引入，无需npm安装：
<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");
<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);
package.json中锁定依赖版本，避免因版本更新导致API变更。 window.ethereum（如MetaMask）作为Provider，以支持用户账户交互， const web3 = new Web3(window.ethereum); // web3.js const provider = new ethers.BrowserProvider(window.ethereum); // ethers.js
安装Web3库是开发DApp的基础步骤，通过npm或CDN均可快速完成，开发者可根据项目需求选择web3.js、ethers.js或viem等库，并结合Provider配置实现与区块链网络的交互，掌握基础安装流程后，后续可深入学习合约部署、交易签名等进阶功能,逐步构建完整的去中心化应用。
友情链接：
