pnpm link

Aliases: ln

Torna o pacote local atual acessível em todo o sistema, ou em outro local.

pnpm link <dir|pkg name>
pnpm link

Opções

pnpm link <dir>

Links package from <dir> directory to node_modules of package from where you're executing this command.

For example, if you are inside ~/projects/foo and you execute pnpm link ../bar, then a link to bar will be created in foo/node_modules/bar.

pnpm link

Links package from location where this command was executed to global node_modules, so it can be referred from another package with pnpm link <pkg>. Além disso, se o pacote tiver um campo bin, os binários do pacote ficarão disponíveis em todo o sistema.

pnpm link <pkg>

Links the specified package (<pkg>) from global node_modules to the node_modules of package from where this command was executed.

Casos de uso

Substitua um pacote instalado por sua versão local

Digamos que você tenha um projeto que usa o pacote foo. Você deseja fazer alterações em foo e testá-las em seu projeto. In this scenario, you can use pnpm link to link the local version of foo to your project.

cd ~/projects/foo
pnpm install # install dependencies of foo
pnpm link # link foo globally
cd ~/projects/my-project
pnpm link foo # link foo to my-project

You can also link a package from a directory to another directory, without using the global node_modules directory:

cd ~/projects/foo
pnpm install # instala dependências de foo
cd ~/projects/my-project
pnpm link ~/projects/foo # vincula foo à my-project

Adicione um binário globalmente

If you are developing a package that has a binary, for example, a CLI tool, you can use pnpm link to make the binary available system-wide. Isso é o mesmo que usar pnpm install -g foo, mas usará a versão local de foo em vez de baixá-la do registro.

Lembre-se que o binário estará disponível somente se o pacote tiver um campo bin em seu package.json.

cd ~/projects/foo
pnpm install # install dependencies of foo
pnpm link # link foo globally

Qual é a diferença entre pnpm link e usar o protocolo file:?

Quando você usa pnpm link, o pacote é vinculado simbolicamente ao código-fonte. Você pode modificar o código-fonte do pacote vinculado e as alterações serão refletidas em seu projeto. Com este método o pnpm não instalará as dependências do pacote vinculado, você terá que instalá-las manualmente no código-fonte. This may be useful when you have to use a specific package manager for the linked package, for example, if you want to use npm for the linked package, but pnpm for your project.

Quando você usa o protocolo file: em dependencies, o pacote é vinculado fisicamente ao seu projeto node_modules, você pode modificar o código-fonte do pacote vinculado e as alterações serão refletidas em seu projeto. Com este método o pnpm também instalará as dependências do projeto vinculado, substituindo o node_modules do pacote vinculado.

informação

When dealing with peer dependencies it is recommended to use the file: protocol. It better resolves the peer dependencies from the project dependencies, ensuring that the linked dependency correctly uses the versions of the dependencies specified in your main project, leading to more consistent and expected behaviors.

Recurso	pnpm link	file: Protocol
Symlink/Hard-link	Symlink	Hard-link
Reflects source code modifications	Yes	Yes
Installs dependencies of the linked package	No (manual installation required)	Yes (overrides node_modules of the linked package)
Use different package manager for dependency	Possible (e.g., use npm for linked pkg)	No, it will use pnpm