PNPM vs Yarn Berry: 의존성 관리 전략과 성능 비교 분석

// package.json
{
  "dependencies": {
    "express": "^4.18.0"
  }
}

// 코드에서 직접 선언하지 않은 패키지 사용 가능
import lodash from 'lodash'; // express의 의존성
// npm/Yarn Classic: 동작 [권장] (잘못된 동작)
// PNPM/Yarn Berry PnP: 에러 [주의] (올바른 동작)

# 10개 프로젝트에서 react 사용 시
npm:         10 × 3.2MB = 32MB (중복 저장)
PNPM:        1 × 3.2MB + 하드링크 = ~3.2MB
Yarn Berry:  1 × 1.8MB (ZIP 압축) = 1.8MB

// .pnp.cjs (간소화된 구조)
const packageRegistry = new Map([
  ["react", [
    ["npm:18.2.0", {
      packageLocation: "./.yarn/cache/react-npm-18.2.0-1eae08fee2-88e38092da.zip/node_modules/react/",
      packageDependencies: new Map([
        ["loose-envify", "npm:1.4.0"],
      ]),
    }],
  ]],
]);
 
// Node.js의 require/import를 가로채기
const originalResolveFilename = Module._resolveFilename;
Module._resolveFilename = function(request, parent, isMain) {
  // .pnp.cjs의 맵을 사용하여 패키지 위치 직접 반환
  return resolveFromPnpMap(request, parent);
};

# .yarnrc.yml
nodeLinker: pnp  # 기본값, 권장

# 구조
.yarn/cache/         # ZIP 파일
.pnp.cjs            # 의존성 맵
# node_modules 없음!

# 구조
node_modules/
└── .bin/
# PNPM과 유사한 하드링크 방식

# 구조
node_modules/
├── react/
└── lodash/
# npm과 동일한 평탄화 구조

# .npmrc
node-linker=isolated  # 기본값

# 구조
node_modules/
├── .pnpm/
│   └── react@18.2.0/node_modules/react/  # 하드링크
└── react -> .pnpm/react@18.2.0/node_modules/react  # 심볼릭 링크

# 구조
node_modules/
├── react/  # 평탄화
└── lodash/

# 구조
.pnp.cjs
# Yarn Berry PnP와 동일

# 동일 파일은 하드링크로 공유
ls -li node_modules/.pnpm/react@18.2.0/node_modules/react/index.js
# 12345678 (inode 번호)
 
ls -li ~/Library/pnpm/store/v3/files/00/a1b2c3...
# 12345678 (동일한 inode - 물리적으로 같은 파일)

# .yarnrc.yml
packageExtensions:
  "legacy-package@*":
    dependencies:
      "missing-peer-dep": "^1.0.0"

// .vscode/settings.json
{
  "typescript.tsdk": ".yarn/sdks/typescript/lib",
  "typescript.enablePromptUseWorkspaceTsdk": true
}

yarn dlx @yarnpkg/sdks vscode

# .yarnrc.yml
enableGlobalCache: false  # 네이티브 모듈은 로컬 캐시 사용

git clone repo
cd repo
npm install  # ← 매번 수 분 소요
npm run dev

git clone repo  # .yarn/cache도 함께 clone
cd repo
yarn run dev  # 즉시 실행!

# Workspace 도구
yarn plugin import workspace-tools
 
# 버전 관리
yarn plugin import version
 
# Interactive 도구
yarn plugin import interactive-tools

// .yarn/plugins/@my/plugin-auto-update.js
module.exports = {
  name: '@my/plugin-auto-update',
  factory: (require) => {
    const { BaseCommand } = require('@yarnpkg/cli');
 
    class AutoUpdateCommand extends BaseCommand {
      async execute() {
        // yarn auto-update 명령 구현
        this.context.stdout.write('Checking for updates...\n');
        // ...
      }
    }
 
    return {
      commands: [AutoUpdateCommand],
    };
  },
};

% constraints.pro
gen_enforced_dependency(WorkspaceCwd, 'react', '18.2.0', DependencyType) :-
  workspace_has_dependency(WorkspaceCwd, 'react', _, DependencyType).

yarn constraints  # 제약 조건 검증

{
  "pnpm": {
    "overrides": {
      "lodash@<4.17.21": "^4.17.21",  # 특정 버전 범위만
      "express>body-parser": "^1.20.0"  # 특정 의존성 체인
    }
  }
}

{
  "resolutions": {
    "lodash": "4.17.21"  # 전역 적용
  }
}

// packages/app/package.json
{
  "dependencies": {
    "shared-lib": "workspace:*",  # 항상 로컬 버전 사용
    "utils": "workspace:^1.0.0"   # 범위 지정 가능
  }
}

# pnpm-workspace.yaml
packages:
  - 'packages/*'
  - 'apps/*'

npm install -g pnpm
pnpm import  # package-lock.json에서 pnpm-lock.yaml 생성

// package.json - 변경 없이 사용 가능
{
  "scripts": {
    "dev": "next dev",
    "build": "next build"
  }
}

# .github/workflows/ci.yml
- name: Install pnpm
  uses: pnpm/action-setup@v2
  with:
    version: 8
 
- name: Install dependencies
  run: pnpm install --frozen-lockfile

# .npmrc
# Phantom dependency를 사용하는 레거시 패키지 대응
public-hoist-pattern[]=*eslint*
public-hoist-pattern[]=*prettier*

yarn set version berry
yarn install

# .yarnrc.yml
nodeLinker: pnp
 
# IDE 지원 설정
yarn dlx @yarnpkg/sdks vscode

# 호환되지 않는 패키지 패치
yarn patch some-legacy-package
# 에디터 열림 → 수정 → 저장
yarn patch-commit -s /tmp/some-legacy-package

# .gitignore 업데이트
echo "!.yarn/cache" >> .gitignore
 
git add .yarn/cache
git commit -m "Enable Zero Install"

// PNPM은 node_modules 구조 유지 → 기존 코드 변경 불필요
import fs from 'fs';
const pkgPath = './node_modules/some-package/package.json';
const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8')); // [권장] 동작

// PnP 모드에서는 파일 시스템 접근 제한
import fs from 'fs';
const pkgPath = './node_modules/some-package/package.json';
const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8')); // [주의] 에러
 
// 해결책: require.resolve 사용
const pkgPath = require.resolve('some-package/package.json');
const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8')); // [권장] 동작

# 자동 설치 활성화
pnpm config set auto-install-peers true

# .npmrc
node-linker=hoisted

yarn dlx @yarnpkg/sdks vscode
# VSCode 재시작 → "Use Workspace Version" 선택

# .yarnrc.yml
nodeLinker: node-modules  # 임시 해결책

yarn add -D @yarnpkg/pnpify
yarn pnpify eslint .

pnpm store prune  # 미사용 패키지 삭제

# .npmrc
fetch-retries=5
network-concurrency=8  # 네트워크 부하 감소

# .yarnrc.yml
compressionLevel: 9  # 최대 압축 (느리지만 Git 저장소 크기 감소)

# .yarnrc.yml
pnpMode: loose  # 엄격한 검증 완화 (속도 향상)