TypeScript Monorepo 该用 Project References 还是单一 tsconfig？

核心判断

针对“TypeScript Monorepo 该用 Project References 还是单一 tsconfig？”，推荐先把目标、风险边界和可验证证据写成契约，再逐步扩大自动化范围。先用可测量的用户任务确定边界，再选择组件、运行时或交互技术，避免技术方案先于问题定义。

实施步骤

1）建立基线：画清数据流、组件边界、所有权和失败路径。2）控制执行：用最小垂直切片验证首屏、交互与可访问性。3）处理失败：对并发、弱网、回滚和兼容性编写自动化测试。4）形成闭环：通过真实用户任务和生产指标决定是否扩大范围。当前场景是“包数量增长后类型检查慢，并出现源码路径与产物类型不一致。”，因此应先做小流量或只读演练，再进入真实写入。

验收与监控

得到适用条件、目录结构和迁移步骤。。至少记录成功率、失败类型、人工接管率、P95 延迟和单位任务成本；对第 38 号方案建立固定回归样例，发布前后使用相同输入对比。

边界与误区

约束是“需要兼顾编辑器性能、构建缓存和发布包边界。”。不要用单一总分或一次演示代替分层验证，也不要把超时当成失败后直接重放；任何外部副作用都必须具备幂等键、状态查询或补偿动作。