当前位置：首页 > backend >正文

web3.js 和 ethers.js 的核心区别

backend 2025/5/6 17:31:59

1. 核心设计理念

---------	web3.js	ethers.js
开发背景	以太坊基金会官方维护	独立开发者创建，社区驱动
架构风格	集中式对象 (web3 为核心)	模块化设计（分离 Wallet/Provider/Contract）
包体积	较大（1MB+）	更轻量（压缩后约 300KB）
TypeScript	类型支持较弱	原生完整类型定义

2. API 风格对比

创建钱包
<JAVASCRIPT>
// web3.js
const account = web3.eth.accounts.create();
const { address, privateKey } = account;
// ethers.js
const wallet = ethers.Wallet.createRandom();
const { address, privateKey } = wallet;
发送交易
<JAVASCRIPT>
// web3.js
const txHash = await web3.eth.sendTransaction({from: address,to: "0x...",value: web3.utils.toWei("1", "ether")
});
// ethers.js
const tx = await wallet.sendTransaction({to: "0x...",value: ethers.parseEther("1")
});
const receipt = await tx.wait(); // 自动等待确认

3. 关键功能差异

功能	web3.js	ethers.js
大整数处理	使用 BN.js 或 BigNumber.js	原生支持 JavaScript 的 BigInt
合约事件监听	依赖 subscribe 方法	使用 contract.on 事件过滤器
错误处理	统一错误类型	细粒度错误类型（如 TransactionReplaced）
ABI 编码	自动填充默认参数	严格类型校验
Provider 抽象	仅支持以太坊节点通信	支持多链（通过自定义 Provider）

4. 异步处理模式

web3.js 的回调风格
<JAVASCRIPT>
web3.eth.getBlockNumber((err, blockNumber) => {if (!err) console.log(blockNumber);
});
ethers.js 的 Promise 优先
<JAVASCRIPT>
const blockNumber = await provider.getBlockNumber();
console.log(blockNumber);

5. 生态系统支持

-----	web3.js	ethers.js
开发者工具	与 Truffle 深度集成	与 Hardhat 生态更紧密
流行框架	更多历史项目使用	新项目采用率更高
文档质量	分散（不同版本差异大）	统一且结构清晰

6. 安全性对比

私钥管理
<JAVASCRIPT>
// web3.js 直接暴露私钥
const account = web3.eth.accounts.privateKeyToAccount(privateKey);
// ethers.js 加密钱包
const encryptedJson = await wallet.encrypt("password");
const restoredWallet = await ethers.Wallet.fromEncryptedJson(encryptedJson, "password");
交易重放保护
web3.js：需手动处理 nonce
ethers.js：自动管理 nonce（可通过 wallet.getTransactionCount() 覆盖）

7. 开发体验差异

智能合约交互
<JAVASCRIPT>
// web3.js
const contract = new web3.eth.Contract(abi, address);
const result = await contract.methods.getValue().call();
// ethers.js
const contract = new ethers.Contract(address, abi, wallet);
const result = await contract.getValue();
单位转换
<JAVASCRIPT>
// web3.js
const weiValue = web3.utils.toWei("1.5", "ether");
// ethers.js
const weiValue = ethers.parseEther("1.5"); // 直接返回 BigInt

8. 适用场景建议

场景	推荐选择	理由
新项目开发	ethers.js	轻量、现代、TypeScript 友好
维护旧项目	web3.js	避免重构成本
需要多链支持	ethers.js	更易扩展自定义 Provider
复杂交易场景	ethers.js	细粒度的错误类型和事件处理
与 Truffle 集成	web3.js	历史项目常用组合