开发环境搭建：Hardhat、Foundry 与编辑器配置

智能合约开发遵循一条固定流水线，本章的环境搭建就是为这条流水线准备工具： 1. 编写：用 Solidity 语言写 .sol 合约源文件。 2. 编译：用 solc 编译器把源码编译成 EVM 字节码（Bytecode）和 ABI 接口文件。

3. 测试：在本地用 JS/TS 测试或 Solidity 测试验证逻辑，配合模糊测试与主网分叉测试。 4. 本地部署：先部署到本地开发链（Hardhat Network / Anvil）反复调试。

4. 测试网部署：部署到 Sepolia 等公共测试网，用免费测试币做端到端验证。 6. 源码验证：在区块浏览器上验证源码，让任何人都能核对链上字节码与源码一致。

5. 安全审计：静态分析 + 手动审计 + 测试覆盖，必要时请第三方审计。 8. 主网部署：多签管理、Timelock 延迟、部署后监控。

先记住这条链路，后面每一章对应其中一个环节。

Hardhat、大多数前端工具和部署脚本都运行在 Node.js 上。到 Node.js 官网 下载 20 LTS 或更高版本（Windows 选 .msi 安装包，macOS 可选 .pkg 或用 nvm，Linux 推荐用 nvm 安装）。

安装完成后打开终端（Windows 用 PowerShell 或 Git Bash）验证：node --version 与 npm --version 能正常打印版本号即可。

建议同时安装 Git（git-scm.com）用于版本管理，并准备好一个终端工具。Windows 用户注意：如果执行 npx 或全局命令时提示「无法加载脚本，因为在此系统上禁止运行脚本」，这是 PowerShell 默认执行策略导致的，可改用项目内的 npm.cmd / npx.cmd，或在了解风险后执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned。

目前行业里有两套事实标准工具链：

建议路径：初学者先学 Hardhat（概念更直观、报错更友好、和前端衔接顺滑），学到测试章节再装 Foundry，最终两者都会用——真实项目经常 Hardhat 负责脚本与前端联调、Foundry 负责高速测试与模糊测试。

新建一个空文件夹并在终端进入，然后执行：npm init -y 初始化 package.json，再执行 npm install --save-dev hardhat 安装 Hardhat。安装完成后运行 npx hardhat，首次运行会出现交互菜单，选择 Create a JavaScript project（或 TypeScript project），同意安装 @nomicfoundation/hardhat-toolbox 这个工具箱（它打包了 ethers.js、测试库、覆盖率、Gas 报告等常用插件）。

初始化完成后执行 npx hardhat compile，如果看到 Compiled 1 Solidity file successfully，说明工具链已经跑通。Hardhat 还内置了一条本地测试链，执行 npx hardhat node 会在 http://127.0.0.1:8545 启动，并预生成 20 个带 10000 ETH 测试余额的账户，专门用于本地调试。

Foundry 由四个命令行工具组成：forge（编译、测试、部署、依赖管理）、cast（直接与链/RPC 交互的瑞士军刀，可查余额、编码 calldata、手动发交易）、anvil（本地开发链，对标 hardhat node）、chisel（快速试 Solidity 语法片段的 REPL）。

安装方式：macOS / Linux 执行官方安装器 curl -L https://foundry.paradigm.xyz | bash 后重开终端运行 foundryup；Windows 用户建议先安装 Foundry for Windows 官方文档给出的方式（或使用 WSL2）。

验证安装：执行 forge --version。想体验它的速度，可以在一个新目录执行 forge init my_project，然后 cd my_project && forge test——它会在毫秒级编译并运行示例测试。

行业默认编辑器是 Visual Studio Code（免费）。安装后在扩展市场搜索并安装 Solidity（Nomic Foundation 出品，即 Hardhat 团队，提供编译错误提示、格式化与 Hardhat 集成）。

可选安装 Solidity Visual Developer（辅助梳理函数调用关系与安全高亮）和 Prettier + prettier-plugin-solidity（保存时自动格式化代码）。

关键配置是编译器版本匹配：Solidity 源文件第一行的 pragma solidity ^0.8.20; 必须与项目实际使用的 solc 版本兼容，否则插件会报红线。在 VS Code 设置（Ctrl+,）里搜索 solidity.defaultCompiler，可设为 localNodeModule 让它直接读取项目 node_modules 里的编译器，保证团队每个人版本一致。

以 Hardhat 项目为例，初始化后的目录各有分工： - contracts/：你写的 Solidity 源文件，一个 .sol 文件可包含多个合约，但通常一个主合约一个文件并同名。

• test/：测试文件，Lock.js / Lock.ts 是生成的示例。 - scripts/：部署与运维脚本，例如 deploy.js。

• ignition/：Hardhat Ignition 声明式部署模块（新版推荐的部署方式）。 - hardhat.config.js：项目的核心配置：Solidity 版本、网络 RPC、插件、验证用的 Etherscan API Key。

• artifacts/：编译产物，每个合约生成包含 ABI 与字节码的 JSON，前端就是靠 ABI 才能调用合约。 - cache/：编译缓存，可随时删除。

Foundry 项目则是 src/（合约）、test/（.t.sol）、script/（.s.sol）、lib/（依赖）、out/（产物）与 foundry.toml 配置。

部署到测试网/主网需要两样敏感信息：RPC 地址（如 Alchemy、Infura 提供的节点 URL，内含 API Key）和钱包私钥。它们绝不能写死在代码或配置文件里，标准做法是： 1. 安装 npm install --save-dev dotenv，在项目根目录新建 .env 文件，写入如 SEPOLIA_RPC_URL=https://eth-sepolia.g.alchemy.com/v2/xxxx 与 PRIVATE_KEY=0x你的测试钱包私钥。

2. 在 hardhat.config.js 顶部 require('dotenv').config()，网络配置里通过 process.env.PRIVATE_KEY 读取。

3. 确认 .gitignore 中包含 .env（Hardhat 模板默认已包含）。

可以用 git status 与 git check-ignore .env 双重确认 .env 不会被提交。

用三个命令验收本章成果： 1. npx hardhat compile——能成功编译示例合约并在 artifacts 目录看到 JSON 产物。 2. npx hardhat test——能运行内置示例测试并全绿（默认在内存中的临时链上运行，无需启动 node）。

3. 新开终端执行 npx hardhat node，再在另一个终端执行 npx hardhat run scripts/deploy.js --network localhost——示例部署脚本会把合约部署到本地链，并在 node 终端实时打印出区块与交易日志。

看到合约地址（0x5FbDB2315678afecb367f032d93F642f64180aa3 这类本地确定性地址）被打印出来，就说明你的编辑器、编译器、本地链、脚本环境全部就绪，可以进入下一章学习 Solidity 语法了。