Windows10下运行npx hardhat node出现HH12错误反复复发怎么解决

HH12错误反复触发的核心原因是Windows环境下本地Hardhat依赖解析优先级低于全局安装包、项目依赖缓存损坏、或者路径解析异常，重建项目仅能临时修复路径/缓存问题，不会根治，按以下步骤操作即可解决：

• 第一步：卸载全局安装的Hardhat
  先执行命令检查全局安装情况：
  npm list -g hardhat
  若返回版本信息，执行全局卸载命令：
  npm uninstall -g hardhat
  若使用yarn作为包管理器，同步执行：
  yarn global remove hardhat
• 第二步：清理项目缓存与损坏依赖
  删除项目根目录下的node_modules文件夹、package-lock.json、yarn.lock文件，Windows PowerShell下可直接执行：
  Remove-Item -Recurse -Force node_modules, package-lock.json, yarn.lock
• 第三步：重新安装项目依赖
  执行本地安装命令：
  npm install
  若使用yarn则执行：
  yarn install
• 第四步：调整启动命令规避全局包优先级问题
  临时启动可直接指定npx仅调用本地依赖：
  npx --no-install hardhat node
  长期使用可在package.json的scripts字段中添加配置：

  {
    "scripts": {
      "node": "hardhat node"
    }
  }
  

  后续启动直接执行：
  npm run node
• Windows环境特有注意项：确认项目存放路径无中文、空格、特殊字符，路径解析异常会导致Hardhat误报HH12错误，建议将项目迁移到全英文无特殊符号的路径下，例如D:\web3\hardhat-project

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