npm install -g solc

npm install -g ganache

本文以Hardhat为例,初始化项目：

mkdir my-eth-project && cd my-eth-project
npm init -y
npm install --save-dev hardhat
npx hardhat

选择Create a basic sample project，按提示生成contracts/（合约代码）、scripts/（部署脚本）、test/（测试文件）等目录。

编写智能合约

智能合约是以太坊项目的核心逻辑载体,需遵循Solidity语法规范，以一个简单的投票合约为例：

1. 创建合约文件：在contracts/目录下创建Voting.sol。
2. 编写合约代码：

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

contract Voting { // 候选人列表（地址 -> 票数） mapping(address => uint256) public votes; // 已投票地址记录 mapping(address => bool) public hasVoted; // 选举管理员 address public admin;

constructor() {
    admin = msg.sender;
}
// 投票函数
function vote() public {
    require(!hasVoted[msg.sender], "You have already voted!");
    votes[msg.sender] = 1;
    hasVoted[msg.sender] = true;
}
// 查询票数
function getVotes(address voter) public view returns (uint256) {
    return votes[voter];
}
// 重置选举（仅管理员）
function resetElection() public {
    require(msg.sender == admin, "Only admin can reset!");
    delete votes;
    delete hasVoted;
}

**编译合约**：在项目根目录运行：  
```bash
npx hardhat compile

编译成功后,artifacts/contracts/目录会生成JSON格式的合约ABI（应用二进制接口）和字节码。

测试智能合约

测试是确保合约安全的关键环节,Hardhat支持JavaScript/TypeScript编写测试用例。

1. 创建测试文件：在test/目录下创建voting.test.js。
2. 编写测试逻辑（使用Chai断言库）：

   const { expect } = require("chai");
   const { ethers } = require("hardhat");

describe("Voting", function () { let Voting; let voting; let owner; let voter1; let voter2;

beforeEach(async function () {
    [owner, voter1, voter2] = await ethers.getSigners();
    Voting = await ethers.getContractFactory("Voting");
    voting = await Voting.deploy();
});
it("Should allow a user to vote", async function () {
    await voting.connect(voter1).vote();
    expect(await voting.hasVoted(voter1.address)).to.equal(true);
});
it("Should prevent double voting", async function () {
    await voting.connect(voter1).vote();
    await expect(voting.connect(voter1).vote()).to.be.revertedWith("You have already voted!");
});
it("Should allow admin to reset election", async function () {
    await voting.connect(voter1).vote();
    await voting.connect(owner).resetElection();
    expect(await voting.hasVoted(voter1.address)).to.equal(false);
});

**运行测试**：  
```bash
npx hardhat test

确保所有测试通过,再进行下一步。

部署合约

部署是将编译后的合约部署到以太坊网络（本地测试网/公共测试网/主网）。

配置网络

在hardhat.config.js中添加网络配置（以本地Ganache为例）：

require("@nomicfoundation/hardhat-toolbox");
module.exports = {
  solidity: "0.8.20",
  networks: {
    ganache: {
      url: "http://127.0.0.1:7545",
      accounts: ["0x..."], // Ganache中的私钥（可选，默认使用第一个账户）
    },
  },
};

编写部署脚本

在scripts/目录下创建deploy.js：

async function main() {
  const Voting = await ethers.getContractFactory("Voting");
  const voting = await Voting.deploy();
  await voting.waitForDeployment();
  console.log("Voting contract deployed to:", await voting.getAddress());
}
main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

执行部署

npx hardhat run scripts/deploy.js --network ganache

成功后,控制台会输出合约地址，此时可通过Ganache查看交易详情。

开发前端交互（DApp必备）

若为DApp项目,需通过前端界面与智能合约交互。

安装前端依赖

npm install --save ethers react react-dom

连接钱包与合约

创建src/App.js（以React为例）：

import { useState, useEffect } from "react";
import { ethers } from "ethers";
import Voting from "./artifacts/contracts/Voting.sol/Voting.json";
function App() {
  const [contract, setContract] = useState(null);
  const [account, setAccount] = useState("");
  const [hasVoted, setHasVoted] = useState(false);
  // 初始化钱包连接
  const connectWallet = async () => {
    if (window.ethereum) {
      try {
        const accounts = await window.ethereum.request({ method: "eth_requestAccounts" });
        setAccount(accounts[0]);
        const provider = new ethers.BrowserProvider(window.ethereum);
        const signer = await provider.getSigner();
        const votingContract = new ethers.Contract(
          "0x...", // 合约地址
          Voting.abi,
          signer
        );
        setContract(votingContract);
        const voted = await votingContract.hasVoted(accounts[0]);
        setHasVoted(voted);
      } catch (error) {
        console.error("Error connecting wallet:", error);
      }
    } else {
      alert("Please install MetaMask!");
    }
  };
  // 投票
  const handleVote = async () => {
    if (contract && account) {
      try {
        const tx = await contract.vote();
        await tx.wait();
        setHasVoted(true);
        alert("Vote successful!");
      } catch (error) {
        console.error("Vote failed:", error);
      }
    }
  };
  return