17.5 阶段 4 Solidity 与合约工程
所属:全栈开发面试题库 / 学习路径 / 17 Web3 全栈
本页目录
一、阶段定位
前面三个阶段都是「看懂链」,本阶段开始「写合约」。它对应题库 15.4 Solidity 与合约工程,是整个 Web3 路径的核心产出阶段——你要真正用 Solidity 写出可编译、可测试、可升级、可部署的合约,并搭起 Foundry/Hardhat 工程。前面 EVM 四区、delegatecall、Gas 计量的知识,在这里变成具体代码决策。
不掌握本阶段会在后面具体卡在哪:
- 只写过「一次性部署就不能改」的合约,到阶段 5 讲代理升级时不知道为什么要留升级路径。
- 没有测试习惯,部署到测试网才发现逻辑错,反复花 Gas。
- 不懂 OpenZeppelin,自己手搓 ERC-20,引入权限与溢出 bug。
- 不懂预言机与外部调用,到阶段 5 讲价格操纵时不理解「链上拿不到真实价格」。
判断自己卡住的标志——(1) 让你写一个带铸造与转账的 ERC-20,你只能抄一段不知所以的代码;(2) 让你解释「为什么要留可升级模式」,你说「合约不是不能改吗」;(3) 让你说清「测试网部署一遍的完整流程」,你只会点 Remix 按钮。出现任一现象,先把本阶段六个模块过一遍再进 阶段 5 合约安全与审计。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能写 Solidity 合约,说清值类型、mapping、可见性、modifier | 能写出带权限控制的合约 |
| 能区分 storage/memory/calldata 在代码里的用法 | 能指出每处变量的数据位置 |
| 能用 OpenZeppelin 写一个 ERC-20 | 能编译、铸造、转账、授权 |
| 能搭 Foundry 或 Hardhat 工程并写测试 | 能跑通测试与本地 fork 测试 |
| 能解释代理升级模式(Transparent/UUPS) | 能说出升级怎么改逻辑不改地址 |
| 能做基础 Gas 优化 | 能指出热点并改写省 Gas |
| 能解释预言机与外部调用的安全 | 能说清 try/catch 与回调风险 |
建议学时:
- 全职(每天 4–6 小时):2.5–3 周,约 55–65 小时。其中语言基础 14 小时、继承接口与升级 14 小时、测试与工程 16 小时、Gas 优化 10 小时、预言机与外部调用 10 小时。
- 在职(每天 2 小时、周末补 4 小时):5–6 周,约 60 小时。
学时分配:语言基础 25%、升级模式 22%、测试工程 26%、Gas 优化 15%、预言机 12%。
三、先修自检
| 先修项 | 合格标准 | 不合格时怎么办 |
|---|---|---|
| 阶段 3 产出 | 能解释 EVM 四区与 delegatecall | 回 阶段 3 |
| 一门语言 | 会写函数、类、条件循环 | 无基础先补一门 JS/Python |
| 命令行 | 能跑 npm/forge 命令 | 用模块 5.3 熟悉 |
| 英文术语 | 认识 contract、modifier、mapping、interface | 记入术语表 |
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| 语言基础 | 值类型、mapping、可见性、modifier | 能讲清原理 | 15.4 Solidity 与合约工程 |
| 数据位置 | storage/memory/calldata 用法 | 能讲清原理 | 15.4 Solidity 与合约工程 |
| 继承与接口 | interface、library、继承、重写 | 会用 | 15.4 Solidity 与合约工程 |
| 升级模式 | Transparent/UUPS/Beacon、__gap |
能讲清原理 | 15.4 Solidity 与合约工程 |
| 测试工程 | Foundry/Hardhat、fork test、fuzz、覆盖率 | 会用 | 15.4 Solidity 与合约工程 |
| Gas 优化 | 减少存储、缓存、批量、打包 | 会用 | 15.4 Solidity 与合约工程 |
| 预言机 | Chainlink、TWAP、try/catch | 了解 | 15.4 Solidity 与合约工程 |
进度管理建议:语言基础、升级模式、测试工程三项必须能独立写出来;Gas 优化与预言机到「会用 + 知道风险点」。
五、分模块精讲
5.1 Solidity 语言基础与数据位置
为什么需要它:Solidity 看着像 JS,但有类型、数据位置、可见性这些 Web3 特有概念。第一关就是把这些写对。
核心机制:
- 值类型:uint、int、address、bool、bytes,固定大小。
- mapping:键值映射,不能遍历,常用于记账。
- 可见性:public(外部可读)、private(仅内部)、external(仅外部调用)、internal(内部与子类)。
- modifier:函数前置检查,如
onlyOwner。 - 数据位置:引用类型(数组、结构体)要标注 storage/memory/calldata。
最小可运行示例:
// 一个最小带权限的合约(示意)
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract SimpleVault {
address public owner;
mapping(address => uint256) public balances;
event Deposited(address indexed user, uint256 amount);
modifier onlyOwner() {
require(msg.sender == owner, "not owner");
_;
}
constructor() {
owner = msg.sender;
}
function deposit() external payable {
balances[msg.sender] += msg.value;
emit Deposited(msg.sender, msg.value);
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 数组没标数据位置 | 引用类型必须标注 | 临时用 memory,入参用 calldata |
| 把 mapping 当可遍历 | mapping 不能遍历 | 需要遍历用数组配合 |
面试考法:问「public/private/external/internal 的区别」。要答到「外部可读性与调用入口的差异」。
5.2 继承、接口与升级模式
为什么需要它:合约部署后地址不变、逻辑可换,靠的就是代理模式。这是生产合约与 Demo 的分水岭。
核心机制:
- interface:只定义函数签名,不实现,用于跨合约调用。
- OpenZeppelin:直接继承 ERC20、Ownable 等,不重复造轮子。
- 代理模式:用户与代理合约交互,代理 delegatecall 到逻辑合约;升级就是换逻辑合约地址。
- Transparent vs UUPS:两种代理实现,UUPS 把升级逻辑放逻辑合约里(机制差异待确认)。
- 存储布局:代理与逻辑合约存储槽必须一致,新增变量用
__gap预留。
最小可运行示例:
# 代理升级流程(文字)
# 1. 部署逻辑合约 V1
# 2. 部署代理合约,指向 V1
# 3. 用户 → 代理(delegatecall V1)
# 4. 部署逻辑合约 V2
# 5. 调用代理的升级函数,改成指向 V2
# 6. 代理地址不变,逻辑变成 V2
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 升级后变量错乱 | 存储槽错位 | 固定槽、__gap、布局一致 |
| 升级权限没收紧 | 任何人都能升级 | 多签/时间锁控制升级权 |
面试考法:问「代理升级怎么做到地址不变、逻辑可换」。要答到「delegatecall 转发 + 存储布局对齐 + 可升级权限控制」。
5.3 合约测试与本地链工程
为什么需要它:合约上链改不了,测试是唯一的免费验证环境。没有测试就上主网,等于裸奔。
核心机制:
- Foundry:用 Solidity 写测试,
forge test跑,快;anvil本地链,cast交互。 - Hardhat:用 JS/TS 写测试,生态成熟,插件多。
- fork test:把本地链分叉到主网真实状态上测试,模拟真实价格与合约。
- fuzz:自动生成随机输入跑测试,发现边界 bug。
- 覆盖率:量化测试覆盖了哪些分支。
最小可运行示例:
# Foundry 常用命令(示意)
forge init my-project # 初始化工程
forge build # 编译
forge test # 跑测试
forge test --fork-url $RPC_URL # fork 主网状态测试
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 只手动测 happy path | 没测异常与边界 | 加 fuzz 与失败用例 |
| 测试在本地过、上测试网挂 | 没 fork 真实状态 | 加 fork test 模拟 |
面试考法:问「为什么要 fork 测试」。要答到「主网真实状态含真实价格与合约,本地空状态测不出集成问题」。
5.4 Gas 优化与代码规范
为什么需要它:阶段 3 讲过写存储贵,这里落到代码手法。Gas 贵到没人用的合约等于没用。
核心机制:
- 减少链上写:合并多次 SSTORE,只存必要状态。
- 缓存 storage 读:在函数里读一次存到 memory,避免重复 SLOAD。
- 批量与打包:把多笔合并成一次,减少调用次数。
- 数据位置:临时数据用 memory/calldata,避免不必要 storage。
- 规范:用 OpenZeppelin、命名一致、注释 NatSpec,可维护性。
最小可运行示例:
// 缓存 storage 读(示意)
// 不推荐:循环里每次读 storage
// 推荐:先读一次到 memory 再循环
uint256 total = balances[msg.sender]; // 读一次
for (uint256 i = 0; i < n; i++) {
total += something; // 用 memory 变量
}
balances[msg.sender] = total; // 写一次
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 循环里反复读 storage | 没缓存 | 先读到 memory |
| 一笔交易里多次写 | 没合并 | 计算完一次性写 |
面试考法:问「常见的 Gas 优化手法」。要答到「缓存读、合并写、数据位置、链下计算」。
5.5 预言机与外部调用
为什么需要它:链上合约拿不到链下真实数据(如 ETH 价格),必须靠预言机。而外部调用是重入与价格操纵的入口,阶段 5 要重点防。
核心机制:
- 预言机:把链下数据(价格、汇率)喂给链上的服务。
- Chainlink:主流去中心化预言机网络,价格喂价(feed)。
- TWAP:时间加权平均价,用一段时间均价抵抗瞬时操纵。
- try/catch:外部调用可能失败,要捕获,不能让整个交易无意义回滚。
- 回调安全:外部调用后控制权交出,要防重入(阶段 5 详讲)。
最小可运行示例:
# 取价流程(文字)
# 合约从 Chainlink 价格喂价读 ETH/USD
# 不用单一交易所现货价(易被瞬时操纵)
# 用 TWAP 或多源聚合,抗操纵
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 用单一交易所现货价 | 易被闪电贷操纵 | 用预言机/TWAP/多源 |
| 外部调用不处理失败 | 没 try/catch | 捕获失败并降级 |
面试考法:问「为什么不能直接用交易所现货价做抵押品估值」。要答到「现货价可被闪电贷瞬时操纵,要用预言机/TWAP」。
5.6 第一个可部署合约
为什么需要它:学完上面五个模块,必须立刻端到端做一遍:写一个继承 OpenZeppelin 的 ERC-20,写测试,部署到测试网。这是阶段 4 的验收产出。
核心机制:
- 继承 ERC20:
is ERC20,构造函数设名称与符号。 - 铸造:
_mint给指定地址。 - 授权与转账:继承自带
approve与transferFrom。 - 部署:脚本部署到测试网,验证合约源码。
最小可运行示例:
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
import {ERC20} from "@openzeppelin/contracts/token/ERC20/ERC20.sol";
contract MyToken is ERC20 {
constructor() ERC20("MyToken", "MTK") {
_mint(msg.sender, 1000000 * 10 ** decimals());
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 自己手搓 ERC20 | 不用库 | 继承 OpenZeppelin |
| 部署后没验证源码 | 前端读不到 ABI | 在区块浏览器验证合约源码 |
面试考法:问「ERC-20 的核心函数有哪些」。要答到「transfer、approve、transferFrom、balanceOf、allowance」。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 搭 Foundry 工程 | init/build/test 跑通 | 测试全绿 | 1.5 小时 |
| 写一个 SimpleVault | deposit 记余额 | 能编译并测存款 | 2 小时 |
| 继承 ERC20 写 MyToken | 铸造 100 万 | 能转账与授权 | 2 小时 |
| 写一个 fuzz 测试 | 随机输入不崩 | fuzz 全绿 | 1.5 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 给合约加 onlyOwner | 非 owner 调用被拒 | 测试覆盖 | 1 小时 |
| 把逻辑合约升级到 V2 | 代理地址不变 | 部署 V2 并切换 | 2.5 小时 |
| 缓存 storage 读 | 看 Gas 下降 | 能说出省了多少 | 1.5 小时 |
| 加 fork 测试 | 分叉主网测集成 | fork 测试通过 | 2 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 设计一个可升级代币 | 选代理模式并写理由 | 能说清存储布局 | 2 小时 |
| 设计取价方案 | 列价格源与抗操纵 | 能说清 TWAP 取舍 | 1.5 小时 |
| 设计测试矩阵 | 正常/异常/边界/fuzz | 覆盖三类用例 | 1.5 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| 编译报数据位置错 | 引用类型未标注 | 看报错行 | 加 memory/calldata |
| 测试在本地过测试网挂 | 没 fork 真实状态 | 加 fork test | 模拟主网状态 |
| 代理升级后变量错乱 | 存储槽错位 | 对比布局 | 固定槽 + __gap |
| 合约调用 Gas 过高 | 循环/写存储多 | 估算看热点 | 缓存读、合并写 |
| 取价被操纵 | 用单一现货价 | 看价格源 | 换预言机/TWAP |
| 部署后前端读不到 | 没验证源码 | 看浏览器是否 verified | 验证合约源码 |
八、出口条件
全部勾选后进入 阶段 5 合约安全与审计。
- [ ] 能写带权限控制的 Solidity 合约,说清可见性与 modifier
- [ ] 能在代码里正确使用 storage/memory/calldata
- [ ] 能用 OpenZeppelin 写一个 ERC-20 并完成铸造、转账、授权
- [ ] 能搭 Foundry/Hardhat 工程,写测试与 fork 测试
- [ ] 能解释代理升级模式与存储布局对齐
- [ ] 能做基础 Gas 优化并指出热点
- [ ] 能解释预言机与外部调用的安全风险
自测题:
- public/private/external/internal 的区别?
- 要点:外部可读性与调用入口差异。
- 代理升级怎么做到地址不变、逻辑可换?
- 要点:delegatecall 转发、存储布局对齐、升级权受控。
- 为什么要 fork 测试?
- 要点:模拟主网真实状态与价格,本地空状态测不出集成问题。
- 常见 Gas 优化手法?
- 要点:缓存 storage 读、合并写、数据位置、链下计算。
- 为什么不能直接用交易所现货价做抵押品估值?
- 要点:现货价可被闪电贷瞬时操纵,要用预言机/TWAP/多源。
- ERC-20 的核心函数?
- 要点:transfer、approve、transferFrom、balanceOf、allowance。