基于npm workspaces的Monorepo中TypeScript依赖与包导入问题

问题1：TypeScript 该装在根目录还是每个子包？ #

两种方案都可行，各有优劣，可根据实际场景选择：

根目录统一安装 #

• 优势：
  • 所有子包共用同一TS版本，避免版本不一致引发的类型校验冲突
  • 减少重复依赖占用，节省磁盘空间，npm install速度更快
  • 可在根目录维护一份tsconfig.json，子包通过extends字段继承配置，无需每个包单独编写，降低维护成本
• 劣势：
  • 子包若需特殊TS版本或个性化配置，灵活性受限，要么单独编写子包的tsconfig覆盖，要么调整根配置适配所有子包
  • 若子包需发布源码而非编译产物，根目录的TS不会被标记为子包的开发依赖，可能导致使用者编译出错（不过Monorepo通常编译后发布，此问题概率较低）

每个子包单独安装 #

• 优势：
  • 每个子包可独立选择TS版本和配置，适合子包技术栈差异较大的场景（比如web用TS5.x，api因依赖老库只能用TS4.x）
  • 子包单独发布时，package.json的devDependencies会正确包含TS，依赖关系更清晰
• 劣势：
  • 多子包安装不同版本TS，易出现类型定义不兼容问题（比如common包用TS5新语法，web包用TS4无法识别）
  • 重复安装依赖，占用更多磁盘空间，安装耗时更长
  • 每个子包需维护独立的tsconfig，配置分散易出现不一致

问题2：api包的工具函数能不能直接给web包用？ #

不是必须移到common包，可以直接从api包导入，但要注意以下几点：

• 确保api包的package.json配置正确：需设置main（编译后的JS入口）、types（类型定义文件入口），让web包能正确识别代码和类型
• 检查工具函数是否包含web环境不兼容代码：比如用到Node.js专属模块（fs、http、path等），直接导入web会导致打包或运行报错，这种情况必须把通用部分移到common包
• 从架构角度考量：跨子包直接导入会增加api和web的耦合度，原本独立的服务/应用互相依赖后，api的代码改动可能直接影响web，后续拆分或维护会更麻烦。如果是通用工具，优先放到common包更合理；如果是api特有但web确实需要的小工具，短期可直接导入，长期建议重构到common包统一维护

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