执行Hardhat Clean报错：找不到@nomicfoundation/hardhat-etherscan模块

执行npx hardhat clean清理Hardhat项目工作区时遇到报错：

npx hardhat clean
An unexpected error occurred: Error: Cannot find module '@nomicfoundation/hardhat-etherscan'

已尝试的解决方法 #

• 安装缺失包：

  npm install --save-dev @nomiclabs/hardhat-etherscan
  

• 删除node_modules和package-lock.json后执行：

  npm install
  

• 检查hardhat.config.js中的导入是否有误

项目配置文件内容 #

hardhat.config.js代码：

require("@nomicfoundation/hardhat-toolbox");
require("@nomicfoundation/hardhat-etherscan");
require("dotenv").config();

const SEPOLIA_RPC_URL = process.env.SEPOLIA_RPC_URL;
const PRIVATE_KEY = process.env.PRIVATE_KEY;
const ETHERSCAN_API_KEY = process.env.ETHERSCAN_API_KEY;

/** @type import('hardhat/config').HardhatUserConfig */
module.exports = {
  defaultNetwork: "hardhat",
  networks: {
    sepolia: {
      url: SEPOLIA_RPC_URL,
      accounts: [PRIVATE_KEY],
      chainId: 11155111,
    },
  },
  etherscan: {
    apiKey: ETHERSCAN_API_KEY,
  },
  solidity: "0.8.9",
};

环境信息 #

• Node.js版本：v22.13.1
• Hardhat版本：2.22.19
• 操作系统：Windows

可能原因及解决方法 #

可能原因 #

1. 包名称不匹配：安装的是@nomiclabs/hardhat-etherscan，但配置文件里导入的是@nomicfoundation/hardhat-etherscan，二者属于不同组织维护的独立包。
2. Toolbox集成依赖未生效：@nomicfoundation/hardhat-toolbox已内置@nomicfoundation/hardhat-etherscan，但可能因安装缓存、依赖冲突导致该模块未正确加载。

解决方法 #

方法1：安装对应包

执行命令安装配置文件中引用的正确包：

npm install --save-dev @nomicfoundation/hardhat-etherscan

方法2：移除单独的etherscan导入（推荐）

由于@nomicfoundation/hardhat-toolbox已集成该模块，可直接删除配置文件中的以下行：

require("@nomicfoundation/hardhat-etherscan");

保存后重新执行npx hardhat clean即可。

方法3：彻底清理后重装

若上述方法无效，执行以下步骤：

1. 删除node_modules、package-lock.json和项目根目录下的.hardhat文件夹
2. 清理npm缓存：

   npm cache clean --force
   

3. 重新安装依赖：

   npm install
   

内容的提问来源于stack exchange，提问作者prajwal