单仓依赖检查器

单仓库依赖检查器 分析单仓库依赖图以查找版本冲突、循环导入、不必要的耦合和包边界违规。 支持 Nx、Turborepo、Lerna、pnpm workspaces 和 npm workspaces。

用法 "检查我的单仓库是否存在依赖问题" "查找包之间的循环依赖" "审计工作区中的版本一致性" "分析我的单仓库中的包边界"

工作原理

• 工作区发现

# 检测单仓库工具 cat nx.json 2>/dev/null && echo "Nx 工作区" cat turbo.json 2>/dev/null && echo "Turborepo" cat lerna.json 2>/dev/null && echo "Lerna" cat pnpm-workspace.yaml 2>/dev/null && echo "pnpm 工作区" # 列出所有包 find . -name "package.json" -not -path "/node_modules/" -maxdepth 3

• 依赖图构建

构建内部依赖图： 哪些包依赖于哪些 直接与间接依赖 包之间共享的依赖 外部依赖版本

• 问题检测

循环依赖：包 A → B → C → A（循环） 影响：构建顺序问题、包大小、测试复杂性 解决方案：提取共享代码到新包或重构 版本冲突：包之间同一外部依赖的不同版本 同伴依赖不匹配 锁文件不一致 不必要的耦合：包导入其他包的内部 共享状态之间的包应该是独立的 测试实用程序泄漏到生产包 边界违规：UI 包导入后端包 功能包依赖于其他功能（应该通过共享） 缺少 package.json 导出字段

• 架构推荐

分层架构：共享 → 域 → 功能 → 应用 每个包中的适当的桶导出（index.ts） 构建顺序优化 CI 中受影响/更改的包检测 包提取候选项（频繁共同更改的文件）

输出

单仓库依赖分析

工具： Turborepo | 包： 12 | 工作区： pnpm

依赖图

app-web → ui、api-client、config、types app-mobile → ui、api-client、config、types api-server → database、config、types、utils ui → types、config api-client → types database → types、config

🔴 循环依赖 (1)

• utils → database → utils

utils/logger 导入 database/connection 用于查询日志 → 将日志配置提取到 config 包

🟡 版本冲突 (3)

包	版本	位置
react	18.2、18.3	app-web vs ui
zod	3.22、3.23	api-server vs types
typescript	5.3、5.4、5.5	各种

### 📊 包健康状况

包	内部依赖	外部依赖	构建顺序	问题
types	0	1	1	✅
config	1	3	2	✅
utils	2	5	3	🔴 循环
ui	2	12	4	🟡 版本
database	2	4	3	🔴 循环

### ✅ 良好实践

• 清晰的分层架构（types → config → 域 → 应用）
• 所有 package.json 文件中的适当导出字段
• 共享的 tsconfig.base.json，具有包级别的扩展
• Turborepo 流水线配置用于增量构建