Web3.js 智能合约开发全流程指南

2026-02-04 04:04:54作者：范垣楠Rhoda

本文将通过 Web3.js 库，详细讲解如何从零开始开发、部署和交互一个区块链智能合约。作为 JavaScript 开发者，掌握这些技能将为你打开区块链开发的大门。

开发环境准备

在开始之前，请确保你的开发环境满足以下要求：

Node.js 环境（建议使用 LTS 版本）
npm 包管理器（通常随 Node.js 一起安装）
基础命令行操作知识

验证安装情况：

node -v
npm -v

项目初始化

首先创建一个新项目并初始化：

mkdir smart-contract-project
cd smart-contract-project
npm init -y

编写智能合约

我们将创建一个简单的合约 MyContract.sol：

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract MyContract {
  uint256 public myNumber;

  constructor(uint256 _myNumber) {
    myNumber = _myNumber;
  }

  function setMyNumber(uint256 _myNumber) public {
    myNumber = _myNumber;
  }
}

这个合约包含：

一个公共状态变量 myNumber
构造函数初始化该变量
一个可更新该变量的公共函数

合约编译

安装 Solidity 编译器：

npm install solc@^0.8.0

创建编译脚本 compile.js：

const solc = require('solc');
const fs = require('fs');

// 读取合约源码
const sourceCode = fs.readFileSync('MyContract.sol', 'utf8');

// 编译配置
const input = {
  language: 'Solidity',
  sources: { 'MyContract.sol': { content: sourceCode } },
  settings: { outputSelection: { '*': { '*': ['*'] } } }
};

// 编译合约
const output = JSON.parse(solc.compile(JSON.stringify(input)));

// 提取字节码和ABI
const bytecode = output.contracts['MyContract.sol'].MyContract.evm.bytecode.object;
const abi = output.contracts['MyContract.sol'].MyContract.abi;

// 保存编译结果
fs.writeFileSync('MyContractBytecode.bin', bytecode);
fs.writeFileSync('MyContractAbi.json', JSON.stringify(abi, null, 2));

console.log('编译成功！');

运行编译：

node compile.js

本地开发环境搭建

安装必要依赖：

npm install web3 hardhat

初始化 Hardhat 项目：

npx hardhat init

启动本地开发节点：

npx hardhat node

这个命令会启动一个本地区块链节点，并生成20个测试账户，每个账户预分配10000测试代币。

合约部署

创建部署脚本 deploy.js：

const { Web3 } = require('web3');
const fs = require('fs');

// 连接到本地节点
const web3 = new Web3('http://127.0.0.1:8545/');

// 加载合约数据
const bytecode = fs.readFileSync('MyContractBytecode.bin', 'utf8');
const abi = require('./MyContractAbi.json');

async function deploy() {
  const accounts = await web3.eth.getAccounts();
  const deployer = accounts[0];
  
  const contract = new web3.eth.Contract(abi);
  
  // 部署合约
  const deployedContract = await contract.deploy({
    data: '0x' + bytecode,
    arguments: [1] // 构造函数参数
  }).send({
    from: deployer,
    gas: 150000,
    gasPrice: '10000000000'
  });

  console.log('合约部署地址:', deployedContract.options.address);
  
  // 保存合约地址
  fs.writeFileSync('MyContractAddress.txt', deployedContract.options.address);
}

deploy();

运行部署：

node deploy.js

与合约交互

创建交互脚本 interact.js：

const { Web3 } = require('web3');
const fs = require('fs');

const web3 = new Web3('http://127.0.0.1:8545/');

// 加载合约
const address = fs.readFileSync('MyContractAddress.txt', 'utf8');
const abi = require('./MyContractAbi.json');
const contract = new web3.eth.Contract(abi, address);

async function interact() {
  const accounts = await web3.eth.getAccounts();
  
  // 读取当前值
  const currentValue = await contract.methods.myNumber().call();
  console.log('当前值:', currentValue);
  
  // 更新值
  const newValue = parseInt(currentValue) + 1;
  const receipt = await contract.methods.setMyNumber(newValue).send({
    from: accounts[0],
    gas: 100000
  });
  
  console.log('交易哈希:', receipt.transactionHash);
  
  // 验证更新
  const updatedValue = await contract.methods.myNumber().call();
  console.log('更新后的值:', updatedValue);
}

interact();