GraphQL Code Generator无法生成类型，遇两类报错求解决

一、GraphQL Code Generator运行报错 #

Generate outputs ❯ Generate to src/lib/graphql.tsx
✔ Load GraphQL schemas
✔ Load GraphQL documents
✖ plugin_helpers_1.DetailedError is not a constructor

二、VS Code类型定义检测问题 #

Cannot find type definition file for 'express-unless'.
The file is in the program because:
Entry point for implicit type library 'express-unless'

已尝试删除node_modules和yarn.lock后重新安装，但问题依旧，以下是针对性解决思路：

解决plugin_helpers_1.DetailedError is not a constructor报错 #

• 统一GraphQL Code Generator依赖版本：这个报错大概率是@graphql-codegen/plugin-helpers和其他codegen插件版本不兼容导致的。打开package.json，检查所有@graphql-codegen/*开头的包版本，确保主包和插件包版本一致，要么全升级到最新稳定版，要么降级到经过验证的兼容版本组合。
• 清理缓存后重装：除了删除node_modules，执行yarn cache clean（yarn环境）或npm cache clean --force（npm环境）清理包管理器缓存，再重新安装依赖。
• 检查codegen配置：确认你的codegen配置文件（比如codegen.yml）里的插件配置是否正确，有没有使用已废弃或版本不匹配的插件。

解决express-unless类型定义缺失问题 #

• 安装对应类型包：express-unless本身可能不带类型定义，直接执行yarn add -D @types/express-unless或npm install --save-dev @types/express-unless安装社区维护的类型定义。
• 调整tsconfig配置：如果安装类型包后仍报错，可在tsconfig.json的compilerOptions中添加"typeRoots": ["node_modules/@types"]，明确指定类型定义的查找路径（当前配置的skipLibCheck已经是true，无需修改）。
• 排查依赖来源：用yarn why express-unless或npm ls express-unless查看该包是哪个依赖引入的，确认是否需要手动安装其类型定义，或者是否可以通过升级引入它的包来解决类型问题。

附：当前tsconfig配置 #

{
  "compilerOptions": {
    "target": "es5",
    "lib": [
      "dom",
      "dom.iterable",
      "esnext"
    ],
    "allowJs": true,
    "skipLibCheck": true,
    "strict": true,
    "baseUrl": "./src",
    "paths": {
      "components/*": [
        "components/*"
      ],
      "lib/*": [
        "lib/*"
      ]
    },
    "strictFunctionTypes": false,
    "forceConsistentCasingInFileNames": true,
    "noEmit": true,
    "esModuleInterop": true,
    "module": "esnext",
    "moduleResolution": "node",
    "resolveJsonModule": true,
    "isolatedModules": true,
    "jsx": "preserve",
    "incremental": true
  },
  "exclude": [
    "node_modules"
  ],
  "include": [
    "next-env.d.ts",
    "src/**/*.ts",
    "src/**/*.tsx"
  ]
}

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