Monorepo下tsconfig报glob隐式类型库入口点错误如何解决

Entry point for implicit type library 'glob' 是TypeScript全局类型自动探测逻辑触发的报错，在TypeScript技术栈Monorepo场景下的常见诱因如下：

• 未显式配置tsconfig的types字段时，TypeScript会默认扫描所有node_modules路径下的类型包，若存在依赖提升带来的幽灵依赖：common子包本身未声明依赖glob或其类型包，但根目录node_modules中残留了不完整的glob相关类型文件，TS探测到后尝试加载入口失败就会抛错。
• 多子包依赖版本冲突：不同子包依赖的glob/@types/glob版本不一致，被包管理器提升到根目录的版本存在类型配置缺失，比如老版本glob未内置类型声明，同时未安装对应匹配版本的@types/glob，或包内package.json的types/typings字段指向的入口文件实际不存在。
• workspace依赖链接异常：使用pnpm/yarn workspace时，软链生成异常导致glob包的类型文件实际路径无法被TS正常解析。
• 根目录tsconfig的typeRoots配置错误，误将普通源码目录识别为类型根目录，把非类型包的glob当成类型库加载。

按优先级从高到低依次验证即可：

• 显式限制全局类型加载范围，在common目录下的tsconfig.json的compilerOptions中添加types配置，阻断TS无差别扫描无关类型包的逻辑：

{
  "compilerOptions": {
    // 保留原有配置，新增以下字段
    "types": []
  }
}

如果common包确实需要用到特定全局类型（比如Node.js、Jest的类型），将对应类型包名填入数组即可，例如"types": ["node"]，仅加载明确声明的全局类型，从根源避免隐式类型库加载错误。

• 若common包代码中确实使用了glob能力，直接在common子包下安装对应类型依赖，注意不要仅在根目录安装，子包使用的依赖必须在子包的package.json中显式声明，规避幽灵依赖问题：

# 按使用的包管理器选择对应命令执行
npm install @types/glob --save-dev
yarn add @types/glob -D
pnpm add @types/glob -D

• 若为依赖链接异常/版本冲突导致，全量清理依赖缓存后重装：

# 清理所有node_modules和对应锁文件
rm -rf node_modules packages/*/node_modules yarn.lock pnpm-lock.yaml package-lock.json
# 重新执行依赖安装
npm install
# 或 yarn install / pnpm install

• 检查根目录tsconfig.json的typeRoots配置，确认路径仅指向合法的类型目录，不要包含业务源码目录或普通npm包的源码路径。

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