Foundry测试中文文档使用指南：本地化术语与实战配套查询路径

中文社区对 Foundry 的关注度越来越高，相应的中文文档也逐渐成熟。本文围绕 Foundry测试中文文档，整理一份实用的查询路径，让你在中文环境下也能高效掌握 Foundry 的各项能力。系统教程入口仍推荐 Foundry测试入门指南。

一、中文文档的价值

中文文档的核心价值在于：

• 术语翻译统一，便于团队沟通
• 配套示例覆盖国内常用的链（币安智能链、波场等）
• 错误信息有中文解读，省去查英文的时间
• 社区问答活跃，遇到问题更快得到答复

这些价值对于中型团队尤其明显，能显著降低新人 onboarding 成本。

二、核心术语对照

中文文档常用术语：

• cheatcode → 作弊码 / 测试钩子
• fuzz → 模糊测试
• invariant → 不变量
• fork → 分叉
• broadcast → 广播 / 提交上链
• selector → 函数选择器

建议团队内部统一一份术语表，避免讨论时各说各话。这份术语表的雏形可参考 Foundry测试官方文档 中文翻译版。

三、cheatcodes 中文化讲解

中文文档对作弊码的解释更贴近开发者直觉：

• vm.prank(addr)：让下一笔调用以 addr 身份发起
• vm.warp(t)：把链上时间跳到 t
• vm.deal(addr, amount)：把 addr 余额改为 amount
• vm.expectRevert：断言下一笔调用会回退

中文示例往往附带常见错误用法，例如忘记 stopPrank 导致后续测试身份串错，这类细节在英文文档中通常被一笔带过。

四、fuzz 与 invariant 章节

中文文档把这两个最难的章节做了重点本地化：

• fuzz 用例的随机种子机制
• bound 与 assume 的差异：前者强制约束，后者过滤无效输入
• invariant 测试的 handler 模式：用一个中间合约扮演用户角色，让 Foundry 在所有方法间随机选择调用

这些内容与 Foundry测试最佳实践 推荐的模式完全一致。

五、分叉测试与币安智能链

中文文档通常专门讲币安智能链：

• BNB Chain 节点 URL 推荐列表
• 分叉测试中如何使用国内付费节点
• 与跨链桥合约（如 Multichain、LayerZero）交互的范例
• 在 Foundry测试漏洞案例 中提到的国内事故复盘

这些内容是英文文档基本不会涉及的本地化补充。

六、错误信息中文化

中文文档列出常见报错的翻译：

• 「could not find contract」：合约名拼写错或没编译
• 「revert at op...」：操作码层 revert，多半是底层调用错误
• 「stack too deep」：变量过多，需要拆函数
• 「fuzz: cannot generate counterexample」：测试约束过严，需放宽 assume

配合 Foundry测试常见错误 内容一起查看，几乎能覆盖日常 90% 的报错场景。

七、与英文文档的互补使用

中文文档不能完全替代英文文档：

• 新功能往往英文文档先更新
• 一些边界细节中文未必同步
• 涉及深度内核的内容仍以英文为准

推荐路径：先用中文文档建立全貌，再用英文文档查具体 API 与边界条件，两者配合效率最高。

八、阅读节奏建议

第一周读完中文文档的入门部分，跑通基础测试；第二周读 cheatcodes 章节并完成至少 20 个测试；第三周精读 fuzz 与 invariant 章节，给项目至少加 5 个 fuzz 测试；第四周精读分叉测试章节，跑一次基于真实链状态的集成测试。按这个节奏走，一个月能从零基础到独立胜任 Foundry 测试工作。中文文档的存在让这条学习路径变得平缓，是社区贡献者的重要价值。