Peer依赖一致性与冲突治理（范围-匹配-阻断）最佳实践

--- title: Peer依赖一致性与冲突治理（范围-匹配-阻断）最佳实践 keywords: - peerDependencies - 范围匹配 - 版本一致性 - 冲突治理 - 阻断 description: 对 peerDependencies 执行范围匹配与一致性校验，发现冲突或不满足约束即阻断并输出修复建议。 categories: - 文章资讯 - 编程技术 --- **实现示例** ```ts function semverValid(v: string): boolean { return /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.test(v) } function matchRange(range: string, v: string): boolean { const m = /^(\^|~)?(\d+)\.(\d+)\.(\d+)$/.exec(range) if (!m || !semverValid(v)) return false const op = m[1] || '' const R = { M: parseInt(m[2],10), m: parseInt(m[3],10), p: parseInt(m[4],10) } const V = v.split('.').map(x => parseInt(x,10)) if (op === '^') return V[0] === R.M && (V[1] > R.m || (V[1] === R.m && V[2] >= R.p)) if (op === '~') return V[0] === R.M && V[1] === R.m && V[2] >= R.p return V[0] === R.M && V[1] === R.m && V[2] === R.p } type Peer = { name: string; required: string; installed: string } function evaluate(peers: Peer[]): { ok: boolean; errors: string[] } { const errors: string[] = [] for (const p of peers) { if (!matchRange(p.required, p.installed)) errors.push(`${p.name}:${p.required}:${p.installed}`) } return { ok: errors.length === 0, errors } } ``` **审计与CI门禁** - 输出不满足约束的清单并阻断；建议升级或统一到兼容版本。 - 关键 peer 约束变更需审批与回归验证。