SuperAPI AI 工具集

dependency-upgrade

编程与开发

查看项目

更新于 10-16 08:22

技能介绍

Dependency Upgrade 是一个面向依赖项主版本升级的技能,核心目标是帮助开发者掌握主版本依赖升级、兼容性分析、分阶段升级策略以及全面的测试方法。

用途与适用时机 该技能适用于以下场景:升级框架主版本;更新存在安全漏洞的依赖;现代化遗留依赖;解决依赖冲突;规划增量升级路径;测试兼容性矩阵;自动化依赖更新。

语义化版本回顾 技能首先回顾语义化版本格式 MAJOR.MINOR.PATCH(例如 2.3.1):MAJOR 表示破坏性变更,MINOR 表示向后兼容的新功能,PATCH 表示向后兼容的错误修复。同时说明版本范围写法:^2.3.1 表示 >=2.3.1 <3.0.0(次版本更新),~2.3.1 表示 >=2.3.1 <2.4.0(补丁更新),2.3.1 表示精确版本。

依赖分析 技能给出依赖审计命令,涵盖 npm 与 yarn:npm outdated、npm audit、npm audit fix;yarn outdated、yarn audit;以及使用 npx npm-check-updates 检查主版本更新,-u 参数可更新 package.json。依赖树分析方面,提供查看某包被安装原因的命令(npm ls package-name、yarn why package-name)、查找重复包(npm dedupe、yarn dedupe)以及用 npx madge --image graph.png src/ 可视化依赖。兼容性矩阵部分给出 JavaScript 示例,定义 react 16.x、17.x、18.x 对应的 react-dom、react-router-dom、@testing-library/react 版本范围,并提供 checkCompatibility 函数用于按矩阵校验包版本。

分阶段升级策略 技能将升级分为三个阶段。第一阶段规划:用 npm list --depth=0 识别当前版本,阅读 CHANGELOG.md 与 MIGRATION.md 检查破坏性变更,并创建包含升级顺序的 UPGRADE_PLAN.md。第二阶段增量更新:强调不要一次性升级所有依赖,建议先更新 TypeScript,测试与构建后再逐个主版本更新 React,随后继续更新 react-router-dom 等包。第三阶段验证:提供兼容性测试示例,检查 react 与 react-dom 版本一致,并检查是否存在 peer dependency 警告。

破坏性变更处理 技能介绍识别破坏性变更的方法,包括直接读取变更日志,并给出 Codemod 自动修复方案:使用 npx jscodeshift -t <transform-url> <path> 执行转换,示例为重命名不安全生命周期方法,支持 --parser=tsx 处理 TypeScript 文件,--dry 预览变更。同时提供自定义迁移脚本示例,通过 glob 遍历 src/**/*.tsx 文件,替换旧 API、更新导入并写回文件。

测试策略 技能列出多层测试手段:单元测试(升级前后确保测试通过,必要时更新测试工具);集成测试(验证应用渲染与导航等交互);可视化回归测试(快照对比);端到端测试(使用 Cypress 完成用户流程)。

自动化依赖更新 技能提供 Renovate 与 Dependabot 的配置示例。Renovate 配置中,minor 与 patch 更新可自动合并,major 更新不自动合并并打上 major-update 标签,且设置每周一凌晨 3 点前的时间表与美东时区。Dependabot 配置指定 npm 生态、每周检查、最多 5 个打开的拉取请求、指定审查者与提交信息前缀。

回滚方案与常见模式 回滚方案给出 bash 脚本:保存当前状态、创建升级分支、尝试升级、运行测试,成功则提交,失败则切回主分支、删除分支并从 package-lock.json 恢复。常见升级模式涵盖锁文件管理(npm install --package-lock-only、npm ci、yarn install --frozen-lockfile、yarn upgrade-interactive)、对等依赖解析(npm install --legacy-peer-deps、npm install --force)、工作区升级(npm install --workspaces、指定 --workspace=packages/app)。

限制 资料未提供该技能的收费、价格、平台支持范围、具体效果指标以及除上述内容之外的其他限制,相关事实暂未提供。