Yarn PnP模式引入redux-saga/effects报TS7016错误如何解决？

问题根因 #

redux-saga 从 v1.0 版本开始已内置官方 TypeScript 类型声明，无需额外安装社区维护的 @types/redux-saga 包。你当前安装的 @types/redux-saga@0.10.5 仅适配 redux-saga 0.x 版本，和你使用的 v1.1.3 版本不兼容，在 Yarn PnP 的严格路径解析规则下会干扰类型识别，最终触发 TS7016 报错。

解决方案 #

按顺序执行以下操作即可在保留 PnP 模式的前提下解决问题：

• 第一步：卸载冲突的第三方类型包

yarn remove @types/redux-saga

• 第二步：清理缓存并重新生成 PnP 依赖映射

yarn cache clean redux-saga
yarn install

• 第三步：若执行后仍报错，可在 tsconfig.json 的 compilerOptions 字段下添加路径映射，强制指定类型文件位置：

{
  "compilerOptions": {
    // 其余原有配置保持不变
    "paths": {
      "redux-saga/effects": ["./node_modules/redux-saga/effects.d.ts"]
    }
  }
}

• 第四步：兜底临时方案：若以上操作都无效，可在项目 src 目录下新建 declarations.d.ts 文件，添加以下内容手动声明模块类型：

declare module 'redux-saga/effects' {
  export * from 'redux-saga/types/effects';
}

需确保 tsconfig.json 的 include 数组包含该声明文件路径。

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