Yarn工作区TypeScript引用类型tsc不识别，但VS Code可正常使用

你的问题核心是VS Code能通过源码识别依赖类型，但tsc编译时无法找到编译后模块的声明文件，主要原因是monorepo中依赖包的配置缺失或模块解析路径未对齐。

可能的问题点及修复步骤 #

1. 补全/graphql包的package.json配置 #

VS Code可直接读取源码类型，但tsc编译时会优先依赖包package.json声明的类型入口。确保/graphql/package.json包含以下配置：

{
  "name": "@goe/graphql",
  "main": "./build/index.js",
  "types": "./build/index.d.ts", // 关键：指定编译后的声明文件入口
  "private": true // monorepo私有包建议添加，避免意外发布
}

• 单独编译/graphql后，确认build目录下存在index.d.ts，且types字段指向路径正确。

2. 配置/ui的模块解析别名 #

你导入用的是@goe/graphql别名，但基础tsconfig仅配置了packages/*映射，需在/ui/tsconfig.json的compilerOptions.paths中补充该别名的映射：

"paths": {
  "@/*": ["src/*"],
  "@/config": ["src/config.ts"],
  "@/components/*": ["src/components/*"],
  "@/assets/*": ["src/assets/*"],
  "@goe/graphql": ["../graphql/build"] // 添加该行，指向graphql编译输出目录
}

3. 规范tsc编译执行方式 #

虽然references会自动触发依赖编译，但缓存可能导致异常。建议先清理编译产物再从根目录执行全量编译：

# 清理旧编译文件
rm -rf packages/frontend/ui/build packages/frontend/graphql/build
# 编译ui（会自动先编译依赖的graphql）
tsc --build packages/frontend/ui

4. 检查isolatedModules与composite的兼容性 #

/ui/tsconfig.json中开启的isolatedModules: true主要用于配合Babel等转译工具，和composite: true可能存在潜在冲突。若上述步骤无效，可临时关闭isolatedModules后重新编译验证。

为什么VS Code能正常工作？ #

VS Code的TypeScript服务默认会扫描monorepo所有源码文件，直接读取/graphql/src中的类型定义，无需依赖编译后的声明文件。但tsc编译遵循严格的模块解析规则，必须通过package.json的types字段或tsconfig的paths映射找到编译后的声明文件。

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