pnpm link

Alias: ln

Menjadikan paket lokal saat ini dapat diakses di seluruh sistem, atau di lokasi lain.

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

Pengaturan

--dir <dir>, -C

• Asali: Direktori kerja saat ini
• Tipe: String jalur lokasi

Mengubah lokasi tautan menjadi <dir>.

pnpm link <dir>

Menautkan paket dari folder <dir> ke paket node_modules daro tempat Anda menjalankan perintah ini atau ditentukan melalui opsi --dir.

Contohnya, jika anda berada dalam ~/projects/foo dan anda menjalankan pnpm link --dir ../bar, maka foo akan terhubung ke bar/node_modules/foo.

pnpm link --global

Menautkan paket dari lokasi tempat perintah ini dijalankan atau ditentukan melalui opsi --dir ke global node_modules, sehingga dapat dirujuk dari paket lain dengan pnpm link --global <pkg>. Juga jika paket memiliki field bin, maka binari paket akan tersedia di seluruh sistem.

pnpm link --global <pkg>

Menautkan paket yang ditentukan (<pkg>) dari node_modules global ke paket node_modules di mana perintah ini dieksekusi atau ditentukan melalui opsi --dir.

Perbedaan antara pnpm link <dir> dan pnpm link --dir <dir>

pnpm link <dir> menghubungkan paket dari <dir> ke node_modules dari paket tempat perintah dijalankan. pnpm link --dir <dir> menghubungkan paket dari tempat kerja saat ini ke <dir>.

# Tempat direktori saat ini adalah foo
pnpm link ../bar

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

# Tempat direktori saat ini adalah bar
pnpm link --dir ../foo

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

Menggunakan Kasus

Mengganti paket yang terinstal dengan versi lokalnya

Katakanlah anda memiliki proyek dengan menggunakan paket foo. Anda akan mengubah ke foo dan mengujinya di proyek anda. Dalam skenario ini, anda dapat menggunakan pnpm link untuk menghubungkan ke versi lokal dari foo pada proyek anda, sedangkan package.json tidak akan diubah.

cd ~/projects/foo
pnpm install # instal dependensi foo
pnpm link --global # hubungkan foo secara global
cd ~/projects/my-project
pnpm link --global foo # hubungkan foo ke proyek-saya

Anda juga dapat menautkan paket dari suatu direktori ke direktori lain, tanpa menggunakan folder global node_modules:

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

Tambahkan biner secara global

Jika Anda mengembangkan paket yang memiliki biner, misalnya alat CLI, Anda dapat menggunakan pnpm link --global untuk membuat biner tersedia di seluruh sistem. Ini sama dengan menggunakan pnpm install -g foo, tetapi ini akan menggunakan versi lokal foo alih-alih mengunduhnya dari registri.

Ingatlah bahwa biner hanya akan tersedia jika paket memiliki bidang bin di package.json.

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

Apa perbedaan antara pnpm link dan menggunakan protokol file:?

Saat Anda menggunakan pnpm link, paket tertaut disinkronkan dari kode sumber. Anda dapat mengubah kode sumber paket yang tertaut, dan perubahannya akan langsung terlihat di proyek Anda. Dengan metode ini pnpm tidak akan menginstal dependensi dari paket tertaut, Anda harus menginstalnya secara manual di kode sumber. Ini mungkin berguna ketika Anda harus menggunakan manajer paket tertentu untuk paket yang tertaut, misalnya, jika Anda ingin menggunakan npm untuk paket yang tertaut, tetapi pnpm untuk proyek Anda.

Ketika Anda menggunakan file : protokol dalam ketergantungan, paket terkait ini hard-linked ke proyek Anda node_modul, Anda dapat memodifikasi kode sumber dari paket yang terkait, dan perubahan akan tercermin dalam proyek Anda. Dengan metode ini pnpm juga akan menginstal dependensi dari paket yang tertaut, menggantikan node_modules dari paket yang tertaut.

info

Saat menangani peer dependencies disarankan untuk menggunakan protokol file:. Adalah lebih baik untuk menyelesaikan ketergantungan peer melalui depedensi proyek, agar memastikan bahwa depedensi yang tertaut telah dengan benar menggunakan versi dari dependensi yang ditetapkan dalam proyek utama Anda, sehingga memiliki perilaku yang lebih konsisten dan sesuai harapan.

Fitur	pnpm link	Protokol file:
Symlink/Hard-link	Symlink	Hard-link
Mencerminkan modifikasi kode sumber	Ya	Ya
Menginstal dependensi paket tertaut	Tidak (diperlukan instalasi manual)	Ya (mengganti node_modules dari paket tertaut)
Gunakan manajer paket yang berbeda untuk depedensi ini	Memungkinkan (misalnya, menggunakan npm untuk paket tertaut)	Tidak, ia akan menggunakan pnpm