为什么选择图文形式
图文教程在「初次上手」阶段特别有效。视频虽然完整,但需要花费数十分钟;纯文字又缺乏视觉锚点。图文教程恰好兼顾节奏与细节,适合在午休或通勤时段碎片化学习。
这一形式在 Binance 学院的入门类内容中也被广泛采用,因为它最贴合「快速建立第一印象」的学习目标。
步骤一:安装 Foundry
打开终端,运行 curl -L https://foundry.paradigm.xyz | bash 完成下载脚本。脚本会自动配置 PATH 与下载预编译二进制。
建议安装完毕立即跑 foundryup,确保拉到的是最新发行版。一切准备就绪后,运行 forge --version,看到版本号即说明安装成功。
步骤二:初始化项目
用 forge init my-first-test 创建一份样板项目。生成的目录中:
- src/Counter.sol 是简单计数器合约
- test/Counter.t.sol 是自动生成的测试样例
- foundry.toml 是项目配置
建议先 forge test 跑一遍,确保环境完全 OK。
步骤三:阅读默认测试
Counter.t.sol 中包含 testIncrement 与 testSetNumber 两个用例。它们演示了:
- 在 setUp 中部署合约
- 在 test 函数中调用方法
- 使用 assertEq 验证结果
这就是 Foundry 测试的最简形态。若想结合 必安 公布的 DeFi 测试模板做对比,建议把它们一并下载并比对差异。
步骤四:编写自定义测试
在同一文件里追加 testSetNumberRevert 用例,模拟「传入参数 0 应当 revert」的负面场景。使用 vm.expectRevert 声明预期错误信息。这一步是新手最容易卡住的环节,请反复练习。
完成后再次跑 forge test,应当看到 PASSED 的绿色提示。如果失败,请逐行排查报错信息,绝大多数问题来自参数类型或错误信息字符串拼写。
步骤五:发布到 GitHub
用 git init 初始化仓库,写一份 README 说明项目结构与测试运行方法。把仓库推到 GitHub 后,可以接入 GitHub Actions 实现 CI 自动测试。
这是从「学习项目」走向「公开作品」的关键一步。配合 Binance合约 等团队公开的合约审计标准,把测试覆盖率纳入 README 徽章,将极大提升项目的可信度。
后续学习
图文教程结束并不意味着学习结束。建议把同样的步骤再做三遍,每一遍尝试增加新功能:第一次加入事件、第二次加入访问控制、第三次加入 ERC20 余额校验。三遍之后,你的 Foundry 实操能力将真正具备生产级别。