别名（Aliases）

别名让您可以使用自定义名称安装软件包。

假设你在项目中大量地使用了 lodash， 但 lodash 中的一个 bug 破坏了你的项目， 为此你修复了这个 bug，但 lodash 并没有合并（merge）它。 通常你会直接从你的 fork 仓库中安装修改过的 lodash (git 托管的依赖) 或者修改一下名称做为新包发布到 npm。 如果你使用第二种解决方式，则必须使用新的包名（require('lodash') => require('awesome-lodash')）来替换项目中的所有引用。 有了别名，你可以有第三种解决方式。

发布一个名为 awesome-lodash 的新包，并使用 lodash 作为别名来安装它：

pnpm add lodash@npm:awesome-lodash

不需要更改代码， 所有的 lodash 引用都被解析到了 awesome-lodash。

有时你会想要在项目中使用一个包的两个不同版本， 很简单：

pnpm add lodash1@npm:lodash@1
pnpm add lodash2@npm:lodash@2

现在，您可以通过 require('lodash1') 引入第一个版本的 lodash 并通过 require('lodash2') 引入第二个。

与钩子结合使用功能会更加强大， 比如你想将 node_modules 里所有的 lodash 引用也替换为 awesome-lodash ， 你可以用下面的 .pnpmfile.cjs 轻松实现：

function readPackage(pkg) {
  if (pkg.dependencies && pkg.dependencies.lodash) {
    pkg.dependencies.lodash = 'npm:awesome-lodash@^1.0.0'
  }
  return pkg
}

module.exports = {
  hooks: {
    readPackage
  }
}