使用HardHat部署Solidity合约遇错误：OpenZeppelin库导入失败

一、OpenZeppelin库文件找不到的排查方案 #

针对报错“@openzeppelin/contracts/token/ERC20/ERC20.sol” not found，按以下步骤逐一验证：

• 确认安装包正确性：确保你安装的是官方维护的@openzeppelin/contracts包，而非已废弃的openzeppelin-solidity。执行npm list @openzeppelin/contracts查看是否安装成功，若未安装或版本异常，删除node_modules和package-lock.json后重新执行npm install @openzeppelin/contracts。
• 验证文件存在性：手动检查node_modules/@openzeppelin/contracts/token/ERC20/ERC20.sol是否存在，若缺失则重新安装依赖。
• 检查HardHat配置：打开hardhat.config.js，确认paths字段未错误修改依赖搜索路径，默认配置下HardHat会自动扫描node_modules，无需额外配置。
• 核对导入语句：确保合约中的导入语句拼写完全正确，无大小写错误或路径格式问题，正确语句应为：

  import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
  

二、Solidity版本不兼容问题处理 #

针对pragma solidity ^0.8.0;引发的版本问题：

• 对齐HardHat编译版本：在hardhat.config.js中，solidity字段指定的编译器版本必须落在pragma声明的范围内。示例配置：

  module.exports = {
    solidity: "0.8.20", // 与^0.8.0兼容
  };
  

• 多版本支持配置：若项目需兼容多个Solidity版本，可使用数组形式配置编译器：

  module.exports = {
    solidity: {
      compilers: [
        { version: "0.8.20" },
        { version: "0.7.6" }
      ]
    }
  };
  

• 清理编译缓存：执行npx hardhat clean清除旧编译文件，再运行npx hardhat compile重新编译，避免缓存导致的版本冲突。

内容的提问来源于stack exchange，提问作者Mohamed Amin Grami