Foundry迁移指南概述：为什么要迁移
Foundry 是一套用 Rust 编写的以太坊智能合约开发工具链，包含 forge、cast、anvil 与 chisel 四个核心组件。相较于传统的 JavaScript 测试框架，Foundry 最大的特点是用 Solidity 直接写测试，编译与测试速度通常快上一个数量级，并原生支持模糊测试（fuzzing）与主网分叉。
本篇 Foundry迁移指南面向已有 Hardhat 或 Truffle 项目的团队，目标是在不破坏现有合约逻辑的前提下，平滑地把工具链切换过来。如果你刚接触工具本身，建议先参考 Foundry入门指南 与 Foundry部署教程 打好基础，再回到迁移流程。
迁移前的准备与机制原理
Foundry 的工作机制与 Node 生态有明显差异：它不依赖 npm 安装合约依赖，而是用 git submodule 管理 lib 目录，并通过 remappings.txt 做路径重映射。理解这一点是迁移成功的关键。
迁移前请先备份现有仓库，并梳理三类资产：合约源码、测试用例、部署脚本。合约源码通常可以原样保留；测试与脚本则需要重写或适配。想深入理解 forge 测试体系，可同时查阅 Foundry测试完整教程 与官方资料 Foundry官方文档、Foundry中文文档，对照阅读能更快建立心智模型。
使用步骤：目录与依赖迁移
第一步，在项目根目录执行 forge init --force（或新建后拷贝），生成标准的 src/、test/、script/、lib/ 结构，并保留 foundry.toml 配置文件。
第二步，处理依赖。把原先 npm 安装的 OpenZeppelin 等库改为 forge install OpenZeppelin/openzeppelin-contracts，随后在 remappings.txt 中加入形如 @openzeppelin/=lib/openzeppelin-contracts/ 的映射，使旧 import 路径继续可用。
第三步，迁移编译配置。把 Hardhat 中的 solc 版本、optimizer runs、evm_version 等设置同步到 foundry.toml。版本不一致是迁移阶段最常见的报错来源，遇到问题可对照 Foundry测试常见错误 逐项排查。
测试迁移：从 JS 到 Solidity
测试迁移是工作量最大的环节。Foundry 测试合约继承自 forge-std/Test.sol，以 test 开头的函数会被自动识别为测试用例，断言使用 assertEq、assertTrue 等，作弊码（cheatcodes）则通过 vm 对象访问，例如 vm.prank、vm.warp、vm.expectRevert。
建议先迁移核心路径的单元测试，再补充模糊测试与不变量测试。进阶写法可参考 Foundry测试进阶教程 与 Foundry测试实战教程；如果在迁移过程中需要逐行定位问题，Foundry测试调试方法 提供了 -vvvv 详细日志与 console.log 的用法说明。
部署脚本迁移与优势
Foundry 用 script/ 目录下的 Solidity 脚本替代 JS 部署脚本，配合 forge script --rpc-url ... --broadcast 完成链上广播。脚本中通过 vm.startBroadcast() 与 vm.stopBroadcast() 包裹需要上链的交易，逻辑清晰且可复用合约类型。
迁移带来的优势相当直接：测试反馈更快、与 EVM 行为更贴近、模糊测试能覆盖更多边界条件，从而提前暴露潜在 Foundry测试漏洞案例 中那类隐蔽缺陷。完整的脚本范式可参考 Foundry测试部署教程。
优势与风险提示
尽管 Foundry 优势明显，迁移仍存在风险。其一，生态成熟度与插件丰富度不及 Hardhat，某些可视化或验证插件可能缺位；其二，团队需要重新熟悉 Solidity 测试范式，存在学习成本；其三，自动化迁移容易遗漏环境变量与网络配置，建议保留旧分支以便回退。
本指南强调：迁移本身不会改变合约的安全属性。即便测试全部通过，也不代表合约没有漏洞，正式上线前仍应进行独立审计。建议持续跟踪 Foundry最新版本 的更新日志，工具链迭代较快，固定版本有助于结果可复现。
常见问题
问：迁移后能否同时保留 Hardhat？ 可以。许多团队采用混合模式，用 Foundry 跑单元与模糊测试、用 Hardhat 做部署与验证，逐步过渡。
问：迁移需要多久？ 取决于测试用例数量。小型项目数小时即可，大型项目建议分模块推进，每迁移一块就跑一遍回归。
问：去哪里查权威资料？ 优先 Foundry官方文档，社区中文资料适合辅助理解，但请以官方为准。
需要提醒的是，本文仅为技术迁移参考，不构成任何投资建议，链上操作存在不可逆风险，请在测试网充分验证后再操作主网。