Solidity智能合约开发入门实战

可视化演示

动态演示Solidity智能合约开发的核心机制，通过源头/管道/节点/终端四种模式展示关键概念与交互流程。

合约结构

想象打开这份《售货机安装说明书》的第一页：左上角印着“本说明书适用于型号 V1.0”，对应 Solidity 源文件第一行的版本声明 pragma solidity ^0.8.0;——它的作用是告诉编译器“请用 0.8 系列的规则来解读我”，避免不同版本语法打架。这一行就像机器铭牌上的型号标签，是整个文件的身份证。

翻到第二页，整份说明书的结构一目了然：一台售货机 = 一个主机箱（contract 关键字）+ 若干存货架（状态变量）+ 一排按钮面板（函数）+ 一个喇叭（事件）+ 一组安全锁（修饰符）。在 Solidity 里，每个 .sol 文件的核心就是一个 contract 定义的“合约蓝图”，它把所有成员按职责装进同一个机箱。你可以给机箱起名 VendingMachine，这个名字将来就是链上合约的标识。

拿到这本说明书，你已经知道售货机由哪些大件组成。接下来，我们要认识其中最贵的零件——那块记录库存的“全网同步存货牌”，也就是状态变量。

状态变量

售货机玻璃橱窗里挂着一块电子存货牌，实时显示“可乐还剩 8 瓶”。这块牌子的特别之处在于：它不是挂在机器里的普通纸片，而是一块“全网同步牌”——只要写上去，全球所有节点都会同步更新，而且永不消失、不可篡改。Solidity 中实现这块牌子靠的就是状态变量。一个状态变量声明在合约顶层，就像这台机器永久安装的一枚零件。

存货牌上能写的数据分两类。一类是“单颗话梅”式的值类型：uint 无符号整数、bool 布尔值、address 账户地址，它们是原子数据，无法再拆分，直接刻在牌上。另一类是“整箱零食”式的引用类型：放一串数据用 array 数组，查表用 mapping 键值映射，打包多个字段用 struct 结构体——比如“可乐（产地、生产日期、价格）”就是一个结构体。

还有一个关键问题：这块牌子挂在哪儿？状态变量默认存放在链上的“永久仓库” storage，写入要花大价钱；函数内部临时使用的局部变量则住在“临时展台” memory，用完即焚，几乎免费。这就是为什么聪明的售货机设计者会尽量减少改写存货牌的次数。

存货牌越贵重，越要谨慎落笔。而顾客和老板真正能操作这块牌子的方式，全在面板的按钮上——那就是函数。

函数进阶

售货机面板上的几排按钮，是顾客唯一能接触的交互界面。Solidity 中用函数定义按钮的行为。按钮分四种权限：public 按钮贴在最外面，谁都能按；external 按钮专供外部顾客使用，本机内部逻辑不响应它；internal 是机箱内部的齿轮，只有内部部件之间联动；private 连老板手册里都只字不提，只有本合约自己知道它的存在。

机器出厂时要做初始设定，比如“初始库存 8 瓶、老板地址是谁”，这就是构造函数 constructor——它只在部署那一刻执行一次，之后机器运转期间不会再被调用。像售货机在工厂通电前最后一次拧紧螺丝，之后就交给新主人了。

函数还能“回话”：returns 声明返回值类型，把计算结果交还给调用者。调用也分两种方式：外部调用要绕一圈（用 this.f() 或合约名 .f()），内部调用直接写 f() 即可——内部调用不需要发交易，所以能省下额外的 Gas。

按钮设计好了，顾客按下后机器做的事情需要被“见证”——这就轮到那个每次出货都会响的喇叭登场。

事件日志

顾客投币买走一瓶可乐，“叮咚”一声响，屏幕闪出“已出货：1 瓶”。这声音不是说给机器自己听的——机器内部早就完成了出货逻辑；它是说给周围所有人听的：刚才发生了一笔交易，全世界都可以来查证。Solidity 里这声“叮咚”就是事件 Event。

用 event 关键字先声明“叮咚长什么样”：名字、要广播的参数。再用 emit 触发：当 buy() 执行成功时，emit Purchased(msg.sender, 1); 就会把“谁、买了多少”广播到链上日志。这个喇叭和普通存储不一样：它不占据昂贵的状态变量空间，而是写入专门的“链上广播记录”。

事件日志有个反直觉的性质：合约自己反而无法读取历史事件！喇叭喊完就没了，合约内部逻辑听不见；只有链下应用（前端 DApp、索引器、监控脚本）可以订阅查询。所以事件通常用来做三件事：前端刷新余额、监控异常交易、留下不可篡改的审计痕迹。

叮咚声让整条街都知道刚才卖出了一瓶，但并不是人人都能开后门补货——接下来，给后门装上老板专属的权限锁。

函数修饰符

老板最关心的事：补货这个按钮，绝对不能让学生按。最笨的办法是在每个函数开头手写一遍“检查一下你是不是老板”。而 Solidity 提供了更优雅的封装——修饰符 Modifier，把检查逻辑抽成一块“安全锁贴纸”，随时贴到任何函数上。

定义 modifier onlyOwner() { require(msg.sender == owner); _; } 拆开看：require 是“守卫”，条件不满足就拒绝执行并让整笔交易回滚；_ 是“钥匙孔”，守卫通过后，机器从这里继续执行被修饰函数的原始代码。用的时候只要在函数声明后面贴上 onlyOwner，这个函数就自动挂上了锁。

修饰符还能叠加，像两把锁串联：onlyOwner 检查完身份，再检查 notPaused 机器是否暂停营业，层层设防。一旦 require 失败，不只是返回一个错误，而是让整笔交易回滚——售货机直接断电重启，恢复到按下按钮之前的状态，谁也别想占便宜。

安全锁封装完毕，售货机的图纸已经完整。下一步是实际动手：把图纸送去工厂铸造，通电营业。

部署实战

图纸画得再好，不铸造成实物就是废纸。Remix IDE 就是你的“售货机制造车间”：打开浏览器访问 remix.ethereum.org，左侧编写代码，点“编译”按钮检查语法并生成字节码，再点“部署”按钮，选择测试账户并确认 Gas 上限，一条交易广播出去，等矿工打包出块确认后——售货机正式通电营业，地址就是你的合约 owner。

整个链上生活的每一笔操作都要缴“电费”，这个费用叫 Gas。计算方式是“用电量 × 电价”：每步 EVM 操作都有固定单价，其中存储操作特别贵（SSTORE 约每字 20000 Gas），而只读查询函数（view）则不花 Gas。Gas 上限是你愿意支付的最高电费，一旦超支交易直接回滚，但已消耗的 Gas 不会退还。

开业后还要防小偷。第一，先更新状态再转账（防“重入攻击”：坏人趁余额未扣反复提款）；第二，敏感操作全部挂上 onlyOwner 锁；第三，接收外部地址前先检查地址有效性，防止资金转入黑洞地址。

从一张说明书到一台通电商用的售货机，你已经走完了 Solidity 开发者的完整旅程——写码、编译、部署、计费、防盗，样样俱全。现在，轮到你去经营自己的第一台链上售货机了。

AI 应用场景

Python 演示

class VendingContract:    """用 Python 模拟一台售货机型智能合约，演示 Solidity 核心概念"""     def __init__(self, owner):        self.owner = owner       # 部署者地址        self.inventory = 10      # 状态变量：库存        self.balance = 0         # 状态变量：合约余额        self.event_log = []      # 事件日志     def is_owner(self, caller):        return caller == self.owner     def buy(self, caller, count):        # 相当于 public 函数：任何人都能调用        if self.inventory < count:            raise ValueError("库存不足，交易回滚")        self.inventory -= count        self.balance += count        self.event_log.append(("Purchased", caller, count))  # emit 事件     def restock(self, caller, count):        # 相当于仅所有者可调用（onlyOwner 修饰符）        if not self.is_owner(caller):            raise PermissionError("非所有者，拒绝补货")        self.inventory += count        self.event_log.append(("Restocked", caller, count))     def withdraw(self, caller, amount):        if not self.is_owner(caller):            raise PermissionError("非所有者，拒绝提现")        if self.balance < amount:            raise ValueError("余额不足，交易回滚")        self.balance -= amount        self.event_log.append(("Withdrawn", caller, amount))  if __name__ == "__main__":    alice = "0xAlice"    bob = "0xBob"    c = VendingContract(alice)    c.buy(bob, 2)       # 顾客购买 2 瓶    c.buy(bob, 1)       # 顾客再买 1 瓶    c.restock(alice, 5) # 所有者补货 5 瓶    try:        c.restock(bob, 1)  # 非所有者补货，会被拒绝    except PermissionError as e:        print("[回滚]", e)    print("库存:", c.inventory, "余额:", c.balance)    for ev in c.event_log:        print("事件:", ev)

1. self.inventory = 10定义状态变量：售货机初始库存，对应 Solidity 里声明在合约顶层的状态。
2. def buy(self, caller, count)定义公开函数：任何账户都能调用，对应 Solidity 的 public。
3. raise ValueError("库存不足，交易回滚")模拟 require 守卫失败：整笔交易回滚，状态保持不变。
4. self.event_log.append(("Purchased", caller, count))模拟 emit 事件：把“谁买了多少”追加进链上日志。
5. if not self.is_owner(caller):权限检查，对应 onlyOwner 修饰符的 require 判断。

常见误区

面试题