pnpm link

別名:ln

現在のローカルパッケージをシステム全体、あるいは、別の場所からアクセス可能にします。

pnpm link <dir>
pnpm link --global
pnpm link --global <pkg>

Options

--dir <dir>, -C

• 初期値: 現在の作業ディレクトリ
• 形式: パス文字列

リンク先を<dir>に変更します。

pnpm link <dir>

<dir>フォルダーのパッケージから、このコマンドを実行したパッケージのnode_modules、あるいは、--dirで指定したディレクトリへリンクを作成します。

たとえば、~/projects/foo 内で pnpm link --dir ../bar を実行すると、foo が bar/node_modules/foo にリンクされます。

pnpm link --global

このコマンドを実行したディレクトリ、または --dir で指定されたディレクトリから、グローバルの node_modules へリンクを作成します。そのため、pnpm link --global <pkg> を実行すると、他のパッケージからこの場所が参照できるようになります。 また、パッケージに bin フィールドがある場合、パッケージのバイナリがシステム全体で使用できるようになります。

pnpm link --global <pkg>

グローバルのnode_modulesから、このコマンドを実行したパッケージのnode_modules、あるいは、--dirで指定したディレクトリへ、指定したパッケージ (<pkg>) のリンクを作成します。

Difference between pnpm link <dir> and pnpm link --dir <dir>

pnpm link <dir> links the package from <dir> to the node_modules of the package where the command was executed. pnpm link --dir <dir> links the package from the current working directory to <dir>.

# The current directory is foo
pnpm link ../bar

- foo
  - node_modules
    - bar -> ../../bar
- bar

# The current directory is bar
pnpm link --dir ../foo

- foo
  - node_modules
    - bar -> ../../bar
- bar

ユースケース

インストールされているパッケージをローカル バージョンに置き換える

foo パッケージを使用するプロジェクトがあるとします。 foo に変更を加え、プロジェクトでテストしたいと考えています。 このシナリオでは、pnpm link 使用すれば foo のローカル バージョンをプロジェクトにリンクしながら、package.json は変更せずにすみます。

cd ~/projects/foo
pnpm install # foo の依存関係をインストールする
pnpm link --global # foo をグローバルにリンクする
cd ~/projects/my-project
pnpm link --global foo # foo を my-project にリンクする

グローバルな node_modules フォルダーを使用せずに、ディレクトリから別のディレクトリにパッケージをリンクすることもできます。

cd ~/projects/foo
pnpm install # foo の依存関係をインストールする
cd ~/projects/my-project
pnpm link ~/projects/foo # foo を my-project にリンクする

バイナリをグローバルに追加する

If you are developing a package that has a binary, for example, a CLI tool, you can use pnpm link --global to make the binary available system-wide. This is the same as using pnpm install -g foo, but it will use the local version of foo instead of downloading it from the registry.

Remember that the binary will be available only if the package has a bin field in its package.json.

cd ~/projects/foo
pnpm install # foo の依存関係をインストールする
pnpm link --global # foo をグローバルにリンクする

pnpm link と file: プロトコルの使用の違いは何ですか？

When you use pnpm link, the linked package is symlinked from the source code. You can modify the source code of the linked package, and the changes will be reflected in your project. With this method pnpm will not install the dependencies of the linked package, you will have to install them manually in the source code. This may be usefull 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.

When you use the file: protocol in dependencies, the linked package is hard-linked to your project node_modules, you can modify the source code of the linked package, and the changes will be reflected in your project. With this method pnpm will also install the dependencies of the linked package, overriding the node_modules of the linked package.

情報

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.

機能	pnpm link	file: プロトコル
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