pnpm monorepo中declare global丢失，跨包导入函数类型失效求助

问题现象 #

从Yarn 1.22迁移至pnpm后，在monorepo工作区中从packages/holograph包导入函数时，该函数对应的全局类型定义丢失，但其他非全局类型可正常识别。

排查结果 #

• Ambient声明文件（如interfaces.d.ts）中声明的类型可被正常识别
• 通过declare global关键字声明的全局类型无法被TypeScript检测到
• 回退代码并使用Yarn安装后，类型恢复正常

相关配置 #

1. pnpm-workspace.yaml #

packages:
  - apps/*
  - packages/*

2. 根目录package.json #

"pnpm": {
    "overrides": {
      "holograph": "link:packages/holograph",
    }
  },

3. app-v2的tsconfig.json #

"include": [
    "next-env.d.ts",
    "src/**/*.ts",
    "src/**/*.tsx",
    "../../packages/**/*.ts",
    "../../packages/**/*.tsx",
    "../../packages/next-config/next.global.d.ts",
  ],

解决方案 #

1. 修正本地包的类型配置 #

在packages/holograph的package.json中，确保types字段指向包含declare global的声明文件：

{
  "types": "./src/global.d.ts"
}

如果有多个声明文件，可通过typesVersions配置更精细的类型映射。

2. 调整pnpm工作区依赖方式 #

移除根目录package.json中的pnpm.overrides配置，改为在app-v2的package.json中直接声明工作区依赖：

"dependencies": {
  "holograph": "workspace:*"
}

pnpm monorepo中通过workspace:*即可自动链接本地包，无需用overrides强制链接，避免类型解析异常。

3. 显式指定依赖包类型 #

在app-v2的tsconfig.json的compilerOptions中，显式添加holograph到types数组：

"compilerOptions": {
  "types": ["holograph"]
}

强制TypeScript加载该包的所有类型定义，包括全局类型。

4. 确保包的类型生成配置正确 #

检查packages/holograph的tsconfig.json，确保以下配置：

{
  "compilerOptions": {
    "declaration": true,
    "declarationDir": "./types"
  },
  "include": ["./src/**/*.d.ts", "./src/**/*.ts"]
}

确保包含declare global的文件被纳入编译，且生成对应的类型声明文件。

验证步骤 #

1. 执行pnpm install重新安装依赖
2. 重启TypeScript服务（如VSCode中按Ctrl+Shift+P选择「TypeScript: Restart TS Server」）
3. 检查全局类型是否恢复正常

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