以太坊智能合约开发：Solidity 与 Remix 实战

FreeGuideOnline 最新 2026-06-15

以太坊智能合约开发：Solidity 与 Remix 实战

1. 什么是以太坊智能合约

以太坊不仅是一个去中心化的数字货币平台，更是一个可编程的区块链。智能合约是运行在以太坊虚拟机（EVM）上的自执行代码，一旦部署就无法篡改，并按照预设规则自动执行。你可以将智能合约看作一个存在于区块链上的自动售货机：输入确定的条件（交易），就会输出确定的结果（状态变更）。

2. 开发环境准备：认识 Remix IDE

Remix IDE 是以太坊官方推出的浏览器内集成开发环境，无需安装任何软件即可编写、编译、部署和调试智能合约。

  • 访问 remix.ethereum.org 即可使用。
  • 主界面分为：文件浏览器、代码编辑器、输出终端和侧边功能栏（编译、部署）。
  • 推荐关闭“代码自动编译”，改为手动触发，避免频繁消耗资源。

3. Solidity 基础速览

Solidity 是一种面向合约的高级语言，语法类似 JavaScript，专为 EVM 设计。

3.1 合约结构

一个最简单的合约：

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

contract SimpleStorage {
    uint256 storedData;

    function set(uint256 x) public {
        storedData = x;
    }

    function get() public view returns (uint256) {
        return storedData;
    }
}
  • SPDX-License-Identifier：许可证声明，必须放在第一行。
  • pragma solidity ^0.8.0：指定编译器版本，^ 表示兼容 0.8.0 及以上但不含 0.9.0。
  • contract 关键字定义合约，类似面向对象的类。

3.2 数据类型核心

  • 值类型：bool、uint256（默认的无符号整数）、int256、address、bytes32。
  • 引用类型：array（定长和动态）、struct、mapping。
  • mapping 是哈希表结构，如 mapping(address => uint256) public balances;。

3.3 函数修饰符

  • public：任何人都可调用，自动生成 getter。
  • private：仅合约内部访问。
  • view：只读状态，不消耗 gas（当从外部调用时）。
  • pure：既不读也不写状态。
  • payable：允许函数接收以太币。

3.4 构造函数与状态变量

address public owner;

constructor() {
    owner = msg.sender; // 部署者地址
}

构造函数仅在合约部署时执行一次。

4. 在 Remix 中编写你的第一个合约

我们来实现一个“存证合约”，记录内容的哈希和所有者。

4.1 合约代码

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

contract ProofOfExistence {
    mapping(bytes32 => address) private proofs;

    // 存储哈希
    function storeProof(bytes32 proof) public {
        require(proofs[proof] == address(0), "Proof already exists");
        proofs[proof] = msg.sender;
    }

    // 验证哈希是否存在
    function checkProof(bytes32 proof) public view returns (bool) {
        return proofs[proof] != address(0);
    }

    // 查询哈希的存储者
    function getProofOwner(bytes32 proof) public view returns (address) {
        return proofs[proof];
    }
}

4.2 关键知识点解释

  • bytes32：定长字节数组，常用于存储 32 字节的哈希值。
  • require(condition, errorMsg)：条件检查，不满足则回滚交易并退还剩余 gas。
  • mapping 未赋值的键默认返回 address(0)，以此判断是否已被存入。

5. 编译合约

在 Remix 左侧功能栏选择 Solidity Compiler 图标。

  1. 选择编译器版本与 pragma 中声明的版本一致（例如 0.8.19）。
  2. 点击“Compile ProofOfExistence.sol”。
  3. 编译成功后，绿色对勾标记，并可查看到 ABI 和字节码。确保没有警告。

6. 部署合约到测试网络

Remix 内置了多种部署环境：

  • Remix VM (Cancun)：浏览器内模拟链，速度快，无需钱包，适合学习。
  • Injected Provider：通过 MetaMask 连接真实网络（如 Sepolia 测试网）。
  • Dev 或 L2 环境：定制开发网络。

本教程使用 Remix VM。

  1. 切换到 Deploy & Run Transactions 标签。
  2. 环境选择 “Remix VM (Cancun)”。
  3. 选择你的合约 “ProofOfExistence”。
  4. 点击 “Deploy”。可以看到终端输出交易哈希，合约出现在 Deployed Contracts 列表。

7. 与合约交互

展开已部署的合约，可直接调用其公开函数。

  • storeProof：

    1. 准备一个 bytes32 参数，如 0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925。
    2. 在输入框中填入，点击 “transact”。
    3. 终端显示交易成功，并消耗了 gas。

  • checkProof： 输入相同的哈希，点击 “call”（蓝色按钮），返回 true。

  • getProofOwner： 输入哈希，返回最初存储者的地址（部署合约的账户地址）。

  • 如果尝试重复存储同一个哈希，会触发 require 错误，终端显示 “Proof already exists” 并回滚。

8. 探索更重要的概念

8.1 事件（Events）

合约中触发事件是向外部提供低成本通知的方式。

event ProofStored(bytes32 indexed proof, address indexed owner);

function storeProof(bytes32 proof) public {
    require(proofs[proof] == address(0), "Proof already exists");
    proofs[proof] = msg.sender;
    emit ProofStored(proof, msg.sender);
}

在 Remix 终端，交易收据内可以看到打印的日志。

8.2 修饰器（Modifier）

修饰器可复用权限检查逻辑。

modifier onlyOwner() {
    require(msg.sender == owner, "Not owner");
    _; // 继续执行原函数体
}

function renounceOwnership() public onlyOwner {
    delete owner;
}

8.3 接收以太币

让合约能持有以太币：

// 接收转账，必须标记 payable
receive() external payable {}

// 获取合约余额
function getBalance() public view returns (uint256) {
    return address(this).balance;
}

在 Remix 中，调用 receive 可以通过在 Low level interactions 区域直接发送以太币（填 Value 并点击 Transact）。

8.4 错误处理进阶

  • require：验证外部输入。
  • revert：主动回滚交易。
  • assert：用于检查内部错误，消耗所有 gas（旧版本）。
  • 自定义错误（Solidity 0.8.4+）更节省 gas：
error Unauthorized();

function onlyOwnerAction() public {
    if (msg.sender != owner) revert Unauthorized();
}

9. 调试智能合约

Remix 提供强大的调试工具。

  1. 在终端找到某笔失败或成功的交易，点击 “Debug”。
  2. 可以单步跟踪每一个 EVM 操作码，观察堆栈、存储和内存的变化。
  3. 在 State 面板可以查看状态变量的最终值。
  4. 通过 Breakpoints 设置断点，调试更高效。

10. 测试合约

Remix 集成了单元测试环境，使用 Solidity 编写测试。 创建测试文件 proof_test.sol：

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import "remix_tests.sol";
import "./ProofOfExistence.sol";

contract ProofTest {
    ProofOfExistence proof;

    function beforeAll() public {
        proof = new ProofOfExistence();
    }

    function testStoreAndCheck() public {
        bytes32 h = keccak256(abi.encode("hello"));
        proof.storeProof(h);
        Assert.equal(proof.checkProof(h), true, "check should be true");
    }
}

在 Solidity Unit Testing 插件中运行，即可看到测试结果。

11. 下一步：从 Remix 到生产

  • 使用 Truffle 或 Hardhat 进行本地开发、测试和部署。
  • 连接 Infura 或 Alchemy 节点，部署到以太坊主网或 Layer2。
  • 遵循安全最佳实践：避免重入攻击、整数溢出（0.8.0+ 已内置检查）、使用 OpenZeppelin 合约库。
  • 永远要在测试网（如 Sepolia）上进行多轮验证。

12. 常见问题

Q: “out of gas” 错误怎么处理？
A: 在 Remix VM 中可调高 Gas Limit；在真实网络中，需估算并设置足够的 gas。

Q: 为什么视图函数会消耗 gas？
A: 如果视图函数被另一个修改状态的函数内部调用，会消耗总交易 gas；外部 call 不消耗。

Q: 如何得到 bytes32 的哈希？
A: 使用 keccak256(abi.encode("任意数据"))，可在 Remix 的 Solidity Compiler 详情中复制 HASH 结果，或使用在线 keccak256 工具。

通过这个完整的实战流程，你已经掌握了用 Solidity 在 Remix 中开发、部署、调试和测试智能合约的核心技能，可以开始构建自己的 DApp 了。