安装Hexo后执行npm install报错：Cannot read properties of null (reading 'matches')

可能的原因 #

该错误多因npm v9.x与Hexo生态部分旧依赖存在兼容性冲突，或package-lock.json文件损坏、版本不匹配导致。

具体解决步骤 #

• 清理现有依赖与锁文件
  彻底移除当前的依赖目录和锁文件，避免残留的不兼容配置干扰：

  # macOS/Linux
  rm -rf node_modules package-lock.json
  
  # Windows
  rmdir /s /q node_modules && del package-lock.json
  

• 降级npm至稳定版本
  npm v9.x在处理部分旧依赖时兼容性较差，降级到v8.x的稳定版本可规避多数此类问题：

  npm install -g npm@8.19.4
  

  完成后重新执行npm install。

• 切换至pnpm安装依赖
  若降级npm仍无效，可尝试使用pnpm替代npm，它的依赖解析机制更稳定，能更好处理版本冲突：

  1. 安装pnpm：

     npm install -g pnpm
     

  2. 清理现有文件后执行安装：

     pnpm install
     

• 手动锁定冲突依赖版本
  若报错信息明确指向某一依赖的版本冲突，直接在package.json中手动指定兼容版本。例如针对hexo-cli的兼容版本：

  "devDependencies": {
    "hexo-cli": "^4.3.0"
  }
  

  修改后重新执行npm install。

• 升级Hexo至最新稳定版
  若你使用的Hexo版本较旧，可能存在与Node.js 18的适配问题，先升级Hexo再安装依赖：

  npm install hexo@latest --save
  

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