在 Mac 上使用 npm 安装 Web3.js 开发指南
时间：
2026-02-14 11:44 阅读数：
1人阅读
Web3.js 是以太坊生态系统中最重要的 JavaScript 库之一，它为开发者提供了与以太坊区块链交互的能力，在 macOS 系统上通过 npm 安装 Web3.js 是进行区块链应用开发的第一步，本文将详细介绍这一过程及其注意事项。
环境准备与安装步骤
确保你的 Mac 已安装 Node.js 和 npm，打开终端，输入 node -v 和 npm -v 检查版本，如果未安装，可通过 Homebrew 安装：brew install node，在项目目录中初始化 npm 项目：npm init -y，然后执行安装命令：
npm install web3
此命令会下载最新版本的 Web3.js 并将其添加到项目的 
npm install web3@1.8.0 等格式。
核心功能与使用示例
安装完成后,在 JavaScript 文件中引入 Web3.js：
const Web3 = require('web3');
const web3 = new Web3('https://mainnet.infura.io/v3/YOUR_PROJECT_ID');
通过 Web3.js，开发者可以执行账户管理、合约交互、交易签名等操作，查询账户余额：
web3.eth.getBalance('0x742d35Cc6634C0532925a3b844Bc454e4438f44e').then(balance => {
console.log(web3.utils.fromWei(balance, 'ether'));
});
常见问题与解决方案
在 Mac 上使用 Web3.js 时，可能会遇到 Node.js 版本兼容性问题，建议使用 LTS 版本 Node.js 以确保稳定性，由于 Web3.js 依赖 Node.js 的加密模块，macOS 的系统完整性保护（SIP）偶尔会导致权限问题，可通过 sudo npm install --global --unsafe-perm=true 解决。
在 Mac 上通过 npm 安装 Web3.js 是构建去中心化应用（DApp）的基础，掌握其安装流程和核心功能后，开发者可以进一步探索智能合约交互、事件监听等高级特性，为区块链开发打下坚实基础，随着 Web3 技术的不断发展，Web3.js 也将持续更新，建议关注官方文档以获取最新动态。