hardhat3 源神 -- 启动！

 这是一篇环境准备 + 克隆构建 + 运行测试 的完整操作文章

📚 Hardhat Verify 项目运行文档（v-next）

适用于：Linux / macOS / WSL2
版本：Hardhat v-next（3.0.3）

🔧 一、环境准备

1. 安装 Node.js（LTS 推荐）

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node --version  # 应输出 v18.x.x 或更高
npm --version   # 应输出 9.x.x 或更高

✅ 推荐 Node.js 18.x LTS

2. 安装 Yarn（必须）

npm install -g yarn

# 验证
yarn --version  # 应输出 1.22.x 或更高

⚠️ 必须用 Yarn，不能用 npm（项目使用 Yarn Workspaces）

3. 配置国内镜像（加速下载）

yarn config set registry https://registry.npmmirror.com

📦 二、克隆并构建项目

1. 克隆仓库

git clone https://github.com/NomicFoundation/hardhat.git
cd hardhat

2. 安装依赖（在根目录运行）

yarn install

✅ 成功标志：无红色 error，看到 Done in ...s

⏱️ 耗时：1~3 分钟

3. 构建所有 TypeScript 包（在根目录运行）

yarn build

✅ 成功标志：看到 Done in ...s，无编译错误

⏱️ 耗时：1~2 分钟

📌 必须从根目录构建，否则 hardhat-verify 无法引用其他包。

🧪 三、运行 hardhat-verify 测试

1. 进入 hardhat-verify 目录

cd v-next/hardhat-verify

2. 运行所有测试

yarn test

✅ 成功标志：

183 passing (4389ms)
Done in 3.67s.

✅ 测试通过即环境完全正确！

⏱️ 耗时：1~2 分钟

💡 如果失败，检查：

• 是否从根目录 yarn install 和 yarn build？
• 网络是否通畅？
• Node.js 版本是否 >= 18？

🛠️ 四、常见问题与解决

❌ yarn: command not found

解决：

npm install -g yarn

❌ workspace not found 或 Cannot find package '@nomicfoundation/hardhat-core'

解决：

• 确认在 hardhat/ 根目录运行了 yarn install 和 yarn build
• 不要只在 hardhat-verify/ 目录下安装

❌ yarn install 下载失败

解决：

yarn config set registry https://registry.npmmirror.com

❌ yarn test 报错 Command "test:unit" not found

解决：

• 使用 yarn test 运行全部测试（不要加 :unit）

❌ yarn build 编译失败

解决：

rm -rf node_modules dist
yarn install
yarn build

📌 命令速查表

✅ 文档结束
✅ 你现在可以运行 hardhat-verify 的所有测试了！