使用rimraf v5.0.0出现TypeScript类型依赖错误求助

问题背景 #

引入rimraf v5.0.0作为devDependency后，运行脚本时出现如下TypeScript错误：

node_modules/@types/glob/index.d.ts:29:42 - error TS2694: Namespace ".../node_modules/minimatch/dist/cjs/index" has no exported member 'IOptions'.
29     interface IOptions extends minimatch.IOptions {
                                            ~~~~~~~~

node_modules/@types/glob/index.d.ts:74:30 - error TS2724: "...node_modules/minimatch/dist/cjs/index" has no exported member named 'IMinimatch'. Did you mean 'Minimatch'?

74         minimatch: minimatch.IMinimatch;
                                ~~~~~~~~~~


Found 2 errors in the same file, starting at: node_modules/@types/glob/index.d.ts:29

手动删除node_modules/@types/glob文件夹后错误消失，但项目未直接依赖glob、minimatch及其类型包，无法通过直接移除依赖解决。

问题原因 #

rimraf v5.x内部依赖了glob v10+，而glob v10+依赖minimatch v9+。minimatch v9+的类型定义已移除IOptions、IMinimatch这类导出（替换为MinimatchOptions和Minimatch类），但项目中某个间接依赖（比如@open-wc系列包、rollup插件等）引入了旧版本的@types/glob，旧类型文件仍期望minimatch导出原有类型，导致类型冲突。

解决方案 #

1. 直接安装兼容版本的@types/glob #

在package.json的devDependencies中添加兼容新版本minimatch的@types/glob版本：

"devDependencies": {
  // ... 原有依赖
  "@types/glob": "^8.1.0"
}

执行npm install（或pnpm/yarn install）重新安装依赖，强制使用兼容的类型包，解决冲突。

2. 用包管理器强制覆盖依赖版本 #

如果使用pnpm/yarn/npm（8.3+），可以通过覆盖规则强制替换所有间接依赖的@types/glob为兼容版本：

• pnpm：在package.json中添加：

  "pnpm": {
    "overrides": {
      "@types/glob": "^8.1.0"
    }
  }
  

• yarn：在package.json中添加：

  "resolutions": {
    "@types/glob": "^8.1.0"
  }
  

• npm：在package.json中添加：

  "overrides": {
    "@types/glob": "^8.1.0"
  }
  

添加后重新安装依赖即可生效。

3. 临时规避：在tsconfig中排除@types/glob #

如果不想额外添加依赖，可在tsconfig.json的exclude数组中排除该类型文件，让TypeScript忽略它：

{
  "compilerOptions": {
    // ... 原有配置
  },
  "exclude": [
    "node_modules",
    "node_modules/@types/glob"
  ]
}

这个方案和手动删除文件夹效果一致，无需每次安装依赖后手动操作。

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