# 기본 설치
pnpm install
 
# CI 환경: lock 파일 기준으로 완전 재현 (lock 파일이 변경되면 에러)
pnpm install --frozen-lockfile
 
# 프로덕션 의존성만 설치 (devDependencies 제외)
pnpm install --prod
 
# 오프라인 설치 (글로벌 스토어에 있는 것만)
pnpm install --offline
 
# lock 파일만 업데이트 (node_modules 는 건들지 않음)
pnpm install --lockfile-only

# 일반 의존성
pnpm add axios
 
# 특정 버전
pnpm add axios@1.6.7
 
# devDependency
pnpm add -D eslint typescript @types/node
 
# peerDependency
pnpm add --save-peer react
 
# optionalDependency
pnpm add --save-optional @next/bundle-analyzer
 
# 전역 설치
pnpm add -g serve
 
# github 레포에서 직접 설치
pnpm add github:user/repo#branch

# package.json 의 SemVer 범위 내에서 모든 패키지 업데이트
pnpm update
 
# 특정 패키지만
pnpm update axios
 
# SemVer 범위 무시하고 최신 버전으로 (package.json 도 변경)
pnpm update --latest
 
# 특정 패키지를 인터랙티브하게 선택해서 업데이트
pnpm update --interactive
pnpm update -i
 
# 🦁 유용한 패턴: @tanstack 스코프 전체 업데이트
pnpm update "@tanstack/*"

# 패키지 제거
pnpm remove axios
 
# devDependency 에서 제거
pnpm remove -D eslint
 
# 전역 패키지 제거
pnpm remove -g serve

pnpm why deepmerge
 
# 출력 예시
youngsu-community@1.0.0 /home/user/projects/youngsu-community
└─┬ @tanstack/react-query@5.17.15
  └─┬ @tanstack/query-core@5.17.15
    └── deepmerge@4.3.1

# 특정 패키지가 어디서 왔는지 상세 트리
pnpm why -r deepmerge  # workspace 전체에서 검색 (모노레포 유용)
 
# JSON 출력
pnpm why --json deepmerge

# 직접 의존성 목록
pnpm list
 
# 전체 의존성 트리 (깊이 제한)
pnpm list --depth=2
 
# 특정 패키지 검색
pnpm list react
 
# 전역 패키지 목록
pnpm list -g
 
# JSON 출력
pnpm list --json

# 업데이트 가능한 패키지 목록
pnpm outdated
 
# 출력 예시
┌──────────────────────────┬─────────┬────────────┬─────────────────────────────────────────────────────────────┐
│ Package                  │ Current │ Latest     │ Details                                                     │
├──────────────────────────┼─────────┼────────────┼─────────────────────────────────────────────────────────────┤
│ @tanstack/react-query    │ 5.17.15 │ 5.28.0     │ https://tanstack.com/query                                  │
│ axios (dev)              │ 1.6.5   │ 1.6.7      │ https://axios-http.com                                      │
└──────────────────────────┴─────────┴────────────┴─────────────────────────────────────────────────────────────┘

# npx 와 동일한 역할
pnpm dlx create-next-app@latest youngsu-community
 
# shadcn/ui 컴포넌트 추가
pnpm dlx shadcn@latest add button
 
# prisma 초기화
pnpm dlx prisma init

# 🦁 create-next-app 으로 프로젝트 생성 시
# pnpm 이 설치된 환경에서 --use-pnpm 플래그 사용
pnpm dlx create-next-app@latest my-app --use-pnpm

# 1단계: 패치할 패키지를 임시 디렉토리로 추출
pnpm patch some-package@1.2.3
 
# 출력:
# You can now edit the package at:
#   /tmp/some-package@1.2.3/
 
# 2단계: 임시 디렉토리에서 파일 수정
# (에디터로 /tmp/some-package@1.2.3/src/index.js 수정)
 
# 3단계: 패치 파일 생성 & 등록
pnpm patch-commit /tmp/some-package@1.2.3

# pnpm-workspace.yaml (또는 package.json 에 자동 추가됨)
patchedDependencies:
  some-package@1.2.3: patches/some-package@1.2.3.patch

# patches/some-package@1.2.3.patch (자동 생성)
diff --git a/src/index.js b/src/index.js
--- a/src/index.js
+++ b/src/index.js
@@ -10,7 +10,7 @@ function brokenFunction() {
-  return undefined;  // 🐛 버그: undefined 반환
+  return [];         // ✅ 수정: 빈 배열 반환
 }

# 영수네 커뮤니티에서 실제로 발생한 상황:
# next-auth 에서 특정 엣지케이스 버그 발견, 공식 수정까지 2주 예상
 
pnpm patch next-auth@4.24.5
# → /tmp/next-auth@4.24.5/ 에서 버그 있는 함수 수정
pnpm patch-commit /tmp/next-auth@4.24.5
 
# 이후 설치할 때마다 patches/next-auth@4.24.5.patch 가 자동 적용됨
# → 공식 패치 릴리즈 후 pnpm patch-remove next-auth@4.24.5 로 제거

# 특정 버전 설치 및 사용
pnpm env use --global 20
 
# LTS 버전 설치
pnpm env use --global lts
 
# 설치된 Node.js 버전 목록
pnpm env list
 
# 원격 사용 가능한 버전 목록
pnpm env list --remote
 
# 특정 버전 제거
pnpm env remove --global 18

# .nvmrc 에 적힌 버전 자동 사용 (pnpm env 는 .nvmrc 를 직접 읽지 않음)
# package.json 의 engines 필드로 버전 제한하고 engine-strict=true 사용 권장

// package.json
{
  "engines": {
    "node": ">=20.0.0",
    "pnpm": ">=9.0.0"
  }
}

# .npmrc
engine-strict=true
# → 잘못된 Node.js 버전으로 pnpm install 시 즉시 에러

# pnpm-lock.yaml
# 💡 이 파일은 우리가 설치한 모든 패키지의 "정확한 지문(버전, 해시값)"을 영수증처럼 보관합니다.
lockfileVersion: '9.0'
 
settings:
  autoInstallPeers: true
  excludeLinksFromLockfile: false
 
# 🦁 1. importers 구역: "누가(프로젝트/앱), 어떤 버전을 요청했는가?"
importers:
  # 프로젝트 루트(.) 에서 요청한 내용
  .:
    dependencies:
      react:
        specifier: ^18.2.0 # package.json에 적힌 원래 버전 (예: ~버전대 언저리)
        version: 18.2.0    # pnpm이 "이번엔 이 버전으로 고정할게!" 하고 낙장불입한 정확한 버전
      next:
        specifier: ^14.2.0
        # 💡 피어(peer) 의존성이 얽히면 이렇게 이름이 길어집니다. (이게 pnpm의 격리 마법!)
        version: 14.2.0(@babel/core@7.24.0)(react-dom@18.2.0(react@18.2.0))(react@18.2.0)
    devDependencies:
      typescript:
        specifier: ^5.3.3
        version: 5.3.3
 
# 🦁 2. packages 구역: "설치된 패키지들의 기술적인 신상정보"
packages:
  react@18.2.0:
    resolution:
      # 💡 다운로드 받은 파일이 중간에 변조되지 않았는지 확인하는 지문(해시값)입니다.
      integrity: sha512-/3IjMdb2L9QbBdWiW5e3P2/npwMBaU9mHCSCUzNln0ZCYbcfTsGbTJrU/kGemdH2IWmB2ioZ+zkxtmq6g09fgQ==
    engines: {node: '>=0.10.0'}
 
  next@14.2.0(@babel/core@7.24.0)(react-dom@18.2.0(react@18.2.0))(react@18.2.0):
    resolution:
      integrity: sha512-...
    engines: {node: '>=18.17.0'}
    peerDependencies:
      '@babel/core': ^7
      react: ^18.2.1
      react-dom: ^18.2.1
    peerDependenciesMeta:
      '@babel/core':
        optional: true # 설치 안 해도 그만인 선택적 피어
 
# 🦁 3. snapshots 구역: "최종적으로 묶여진 가족사진 (의존성 트리)"
snapshots:
  react@18.2.0:
    dependencies:
      loose-envify: 1.4.0 # react가 동작하려면 이 친구가 무조건 필요해!
 
  next@14.2.0(@babel/core@7.24.0)(react-dom@18.2.0(react@18.2.0))(react@18.2.0):
    dependencies:
      react: 18.2.0
      react-dom: 18.2.0(react@18.2.0)

# npm 의 CI 명령어
npm ci
 
# pnpm 의 동일한 역할
pnpm install --frozen-lockfile
# → lock 파일이 package.json 과 일치하지 않으면 에러 발생
# → 새 패키지를 설치하거나 lock 파일을 수정하지 않음
# → CI 환경에서 항상 이 옵션 사용 권장

# merge conflict 발생 시 — pnpm 이 자동으로 재해석해줌
git checkout --theirs pnpm-lock.yaml   # 상대방 버전 선택
pnpm install --lockfile-only            # lock 파일만 재생성
 
# 또는 conflict marker 를 제거하고
pnpm install --merge-git-lockfiles      # git merge 상황에서 자동 병합