pnpm link 써보니… 로컬 패키지 개발이 이렇게 편해질 줄 몰랐습니다 🚀

안녕하세요, 개발자 여러분! 😊
오늘은 제가 실무에서 직접 사용해본 pnpm link 명령어에 대해 자세히 알려드릴게요.
사실 저도 예전엔 npm link만 쓰다가 이번에 pnpm으로 바꿔봤는데, 훨씬 깔끔하고 편하더라고요.

---

✅ pnpm link란?

간단히 말하면, pnpm link는 로컬에서 개발 중인 패키지를 다른 프로젝트에 연결해주는 기능입니다.
npm에 배포하지 않아도 바로 연결해서 테스트할 수 있어서, 패키지 개발할 때 정말 유용해요.

저 같은 경우 라이브러리 작업하면서 매번 버전 올리고 배포하는 게 귀찮아서 link 기능 써봤는데,
진짜 개발 속도가 달라지더라고요.

---

✅ 실제로 써본 사용 방법 - 단계별 정리

1️⃣ 패키지 준비

먼저 테스트할 패키지 하나 만들어줍니다.

mkdir my-package
cd my-package
pnpm init

package.json에서 이름도 정리해줬습니다.

{
  "name": "my-package",
  "version": "1.0.0"
}

---

2️⃣ 전역 링크 등록

이제 패키지 폴더에서 전역 링크 만들어줍니다.

pnpm link --global

 

→ 이러면 my-package가 전역 저장소에 등록돼요.

---

3️⃣ 다른 프로젝트에서 연결하기

이제 사용할 프로젝트로 이동해서:

cd ../my-project
pnpm link --global my-package

 

끝!
바로 my-package를 import 해서 쓸 수 있습니다.

---

4️⃣ 링크 해제 방법

나중에 연결 해제하고 싶으면 이렇게 하면 됩니다:

pnpm unlink my-package

그리고 원본 패키지 폴더 가서:

 

pnpm unlink --global

 

---

✅ 써보니까 좋았던 점

✔ 로컬 개발 속도 확 올라갑니다 — 매번 배포 안 해도 바로 테스트
✔ 수정하면 바로 적용 — 리로드 없이 코드 반영
✔ 서로 의존성 꼬이는 일 줄어듬

---

✅ 주의할 점도 있어요

• 이건 개발용 전용입니다. 프로덕션 배포에서는 절대 쓰면 안 됩니다.
• 링크된 패키지 수정하면 바로 반영되니 테스트 주의 필요해요.

---

✅ 개인적인 결론 - 패키지 개발자라면 무조건 써보세요

솔직히 pnpm link 덕분에 이번 프로젝트에서 테스트 시간 엄청 단축했어요.
npm 배포하고 다시 설치하는 시간 아끼니까 생산성이 확 올라가더라고요.

혹시 여러분도 라이브러리나 공통 패키지 작업하신다면 꼭 한 번 써보시길 추천합니다!

---

💬 혹시 써보신 분 계신가요?

pnpm link 사용해보신 경험이나,
실제로 겪어본 문제나 꿀팁 있으시면 댓글로 공유해주시면 좋겠습니다 😊