TypeScript Hardhat项目tsconfig.json引用文件缺失报错的修复咨询

问题原因 #

该错误源于@nomicfoundation/hardhat-chai-matchers与hardhat（对应底层依赖@nomicfoundation/hardhat-core）的版本不兼容，前者的TS配置引用了后者不存在的源码路径。

修复方案 #

1. 统一依赖版本 #

• 检查项目根目录package.json，确认hardhat和@nomicfoundation/hardhat-chai-matchers的版本是否匹配，建议统一使用最新稳定版。
• 执行命令更新依赖：

  # npm 版本
  npm install --save-dev hardhat@latest @nomicfoundation/hardhat-chai-matchers@latest
  # yarn 版本
  yarn add --dev hardhat@latest @nomicfoundation/hardhat-chai-matchers@latest
  

2. 清理并重装依赖 #

若版本更新后问题未解决，清理缓存与旧依赖后重新安装：

# 删除依赖文件夹和锁文件
rm -rf node_modules package-lock.json
# 重新安装
npm install

3. 忽略node_modules的TS检查（临时规避） #

在项目根目录的tsconfig.json中添加排除规则，让TypeScript跳过node_modules内的文件检查，消除编辑器标红：

{
  "exclude": [
    "node_modules",
    "dist",
    "typechain-types"
    // 保留项目原有排除路径
  ]
}

4. 手动修正TS配置（不推荐） #

不建议直接修改node_modules内的文件（后续依赖更新会覆盖），但临时应急可打开/***/node_modules/@nomicfoundation/hardhat-chai-matchers/src/tsconfig.json，删除references字段中指向@nomicfoundation/hardhat-core/src的无效条目。

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