跳到主内容
版本：11.x

pnpm link

别名: ln

Links a local package to the current project's node_modules.

pnpm link<dir>

配置项​

将 <dir> 目录中的软件包链接到执行此命令的软件包的 node_modules。 <dir> must be a relative or absolute path.

例如，如果你在 ~/projects/foo 下，并且执行 pnpm link ../bar，那么将在 foo/node_modules/bar 中创建指向 bar 的链接。

Breaking changes in v11

pnpm link no longer resolves packages from the global store. Only relative or absolute paths are accepted (use pnpm link ./foo instead of pnpm link foo).

pnpm link --global has been removed. To register a local package's bins globally, use pnpm add -g . instead.

pnpm link with no arguments has been removed. Always pass an explicit path.

用例​

将已安装的软件包替换为本地版本​

假设你有一个使用 foo 包的项目。 你想要对 foo 进行更改并在你的项目中测试它们。 In this scenario, you can use pnpm link to link the local version of foo to your project:

cd ~/projects/foo
pnpm install # 安装 foo 的依赖
cd ~/projects/my-project
pnpm link ~/projects/foo # 链接 foo 到 my-project

全局添加二进制文件​

To make a local package's binaries available system-wide, use pnpm add -g . instead:

cd ~/projects/foo
pnpm install # install dependencies of foo
pnpm add -g . # register foo's bins globally

请记住，仅当包的 package.json 中有 bin 字段时，二进制文件才可用。

当你使用 pnpm link时，链接的包是从源代码进行符号链接的。 你可以修改链接包的源代码，所做的更改将反映在你的项目中。 使用这种方法 pnpm 将不会安装链接包的依赖项，你必须在源代码中手动安装它们。 当你必须对链接包使用特定的包管理器时，这可能会很有用，例如，如果你想对链接包使用 npm ，但你的项目使用 pnpm。

当你在 dependencies 中使用 file: 协议时，被链接的软件包将硬链接到你的项目的 node_modules 中，你可以修改被链接软件包的源代码，并且这些修改将反映在你的项目中。 使用此方法，pnpm 还会安装链接包的依赖项，覆盖链接包的 node_modules。

提示

在处理 对等依赖 时，建议使用 file: 协议。 它更好地解决了项目依赖项中的对等依赖项，确保链接的依赖项正确使用主项目中指定的依赖项版本，从而实现更加一致和预期的行为。

功能pnpm linkfile: 协议
符号链接/硬链接符号链接硬链接
反映源代码修改是是
安装链接包的依赖项否（需要手动安装）是（覆盖链接包的 node_modules）
使用不同的包管理器来实现依赖可以（例如，对链接的包使用 npm）不可以，它将使用 pnpm