• 你为什么要这么做？
  • 如何使用它？
  • 提示和技巧
  • 限制和警告

    package.json 文件里的 resolutions 字段用于解析选择性版本，可以通过此功能自定义依赖版本。 这通常需要手动编辑 yarn.lock 文件。

    你为什么要这么做？

    • 有些时候，项目会依赖一个不常更新的包，但这个包又依赖另一个需要立即升级的包。 这时候，如果这个（不常更新的）包的依赖列表里不包含需要升级的包的新版本，那就只能等待作者升级，没别的办法。

    • 项目的子依赖（依赖的依赖）需要紧急安全更新，来不及等待直接依赖更新。

    • 项目的直接依赖还可以正常工作但已经停止维护，这时子依赖需要更新。 同时，你清楚子依赖的更新不会影响现有系统，但是又不想通过 fork 的方式来升级直接依赖。

    • 项目的直接依赖定义了过于宽泛的子依赖版本范围，恰巧这其中的某个版本有问题，这时你想要把子依赖限制在某些正常工作的版本范围里。

    如何使用它？

    在 package.json 文件里添加 resolutions 字段，用于覆盖版本定义：

    package.json

    1. {
    2.   "name": "project",
    3.   "version": "1.0.0",
    4.   "dependencies": {
    5.     "left-pad": "1.0.0",
    6.     "c": "file:../c-1",
    7.     "d2": "file:../d2-1"
    8.   },
    9.   "resolutions": {
    10.     "d2/left-pad": "1.1.1",
    11.     "c/**/left-pad": "1.1.2"
    12.   }
    13. }

    之后执行 yarn install。

    提示和技巧

    • 如果定义了无效的版本解析规则，比如错写了无效的包名，会收到警告。
    • 如果定义的版本解析的版本号、版本范围无效，也会收到警告。
    • 如果定义的版本解析规则的版本号、版本范围与原始版本范围不兼容，同样会收到警告。

    限制和警告

    • 嵌套包机制（Nested packages）可能会挂。
    • 这是一项新功能，因此会在某些极端情况下挂掉。

    原文: https://yarnpkg.com/zh-Hans/docs/selective-version-resolutions