You need to enable JavaScript to run this app. yarn workspaces下如何让tsc仅加载项目实际依赖的node_modules类型?
优惠活动
大模型
产品
解决方案
定价
更多

yarn workspaces下如何让tsc仅加载项目实际依赖的node_modules类型?

优化TypeScript monorepo编译时多余文件加载的方案

核心原因

你遇到的问题是TypeScript默认的类型自动扫描逻辑和yarn workspaces扁平化依赖提升特性叠加导致的:

  • TypeScript默认会自动从当前项目向上追溯的所有node_modules/@types目录下加载全部类型包
  • yarn workspaces会将所有公共依赖提升到根目录的node_modules,扁平化存储后,当前包不需要的其他包依赖也会存在于上述扫描路径中
    最终大量冗余类型文件被纳入解析,直接推高了Parse time的耗时。

补充说明:skipLibCheck仅会跳过对.d.ts类型声明文件的类型检查逻辑,不会减少这些文件的加载、解析耗时,因此无法解决当前parse时间过高的问题。

具体调整步骤

1. 显式配置types字段,关闭全局@types自动引入

这是最核心的优化点:在server包的tsconfig.json的compilerOptions中,手动列出你需要用到的全局类型包列表,TS就不会再自动加载typeRoots下的所有@types包,只会加载你列出的项。
比如如果你的server项目只用到了Node.js环境和Express的全局类型,就配置:

{
  "compilerOptions": {
    "types": ["node", "express"]
  }
}

注意:如果你之前没有配置过这个字段,默认行为是加载所有@types下的包,这也是冗余文件的最主要来源。不要把这个字段设为空数组,否则会完全加载不到全局类型,按需列出即可。

2. 限定typeRoots的查找范围

如果不需要TS向上追溯到其他层级的node_modules,可以显式指定类型根目录的查找路径,避免扫到意外的目录:

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "../../node_modules/@types"]
  }
}

仅保留当前包自身的node_modules/@types以及根目录被hoist的公共依赖目录即可。

3. 严格收窄include与exclude范围

确保tsconfig仅扫描当前包的源码文件,不要误扫到同级的client包或者其他无关文件:

{
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist", "**/*.test.ts"]
}

不要使用过宽的匹配规则比如../**/*,避免引入相邻包的源码文件。

4. 排查项目引用配置

如果使用了TypeScript的Project References(对应references配置项),检查是否误将client包加入了引用列表,仅保留当前包实际依赖的workspace项目即可。

5. 可选:调整模块解析模式

如果使用的是TypeScript 4.7+版本,可以将moduleResolution配置为bundler或者node16,更适配yarn workspaces的依赖结构,减少不必要的路径回溯逻辑。

效果验证

调整完成后,先删除server包下旧的.tsbuildinfo增量缓存文件(避免旧的文件列表干扰验证结果),再运行tsc --diagnostics和tsc --listFiles:

  • 对比Files字段的数量是否明显下降
  • 查看--listFiles输出中是否还存在未在server包的package.json依赖声明中出现的第三方类型文件
    一般经过上述调整后,解析时加载的文件数量会大幅降低,对应的Parse time也会同步下降。

内容的提问来源于stack exchange,提问作者Julien Fouilhé

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 01:06:08