pnpm 지원

pnpm에 대한 지원은 현재 실험적입니다. 이를 활성화하려면 환경 변수 VOLTA_FEATURE_PNPM이 1로 설정되어 있는지 확인하세요. Windows에서는 시스템 설정에서 사용자 또는 시스템 환경 변수에 추가할 수 있습니다. Linux/Mac에서는 구성 파일 스크립트(예: .bash_profile, .zshrc 또는 유사한 파일)에서 해당 값을 설정할 수 있습니다.

이 지원이 실험적이므로 일부 해결되지 않은 문제가 있을 수 있습니다. 아래에 알려진 제한 사항이 나열되어 있지만, Volta의 pnpm 사용 중 예상대로 작동하지 않는 경우가 있다면 GitHub에서 문제를 제기해 주시기 바랍니다.

알려진 제한 사항

전역 설치

현재 전역 설치(예: pnpm install -g)는 지원되지 않으며 오류가 발생합니다.

마이그레이션

현재 자동 마이그레이션이 없으므로, 이전에 pnpm을 Volta 전역으로 설치한 경우 volta install pnpm을 호출하여 수동으로 다시 설치해야 합니다. 지원을 활성화하고 다시 설치하기 전에 volta uninstall pnpm을 통해 이전에 설치된 pnpm 패키지를 제거할 수 있습니다. 네이티브 pnpm 지원으로 전환한 후에는 현재 제거 구현이 부족하여 동일한 명령을 호출하여 격리된 이전 pnpm 패키지를 삭제할 수 없습니다.

pnpm 지원 활성화

Unix(Linux/macOS)에서

셸 구성 파일(.bashrc, .zshrc 등)에 다음 행을 추가하세요:

export VOLTA_FEATURE_PNPM=1

그다음 셸을 다시 로드하거나 다음을 실행하세요:

source ~/.bashrc  # 또는 특정 구성 파일

Windows에서

1. 시작 메뉴를 열고 "환경 변수"를 검색합니다
2. "시스템 환경 변수 편집"을 클릭합니다
3. 시스템 속성 창에서 "환경 변수"를 클릭합니다
4. "사용자 변수" 아래에서 "새로 만들기"를 클릭합니다
5. 변수 이름으로 "VOLTA_FEATURE_PNPM", 값으로 "1"을 입력합니다
6. "확인"을 클릭하여 모든 대화 상자를 닫습니다

Volta와 pnpm 사용하기

pnpm 지원을 활성화한 후에는 다음을 수행할 수 있습니다:

1. pnpm을 기본 패키지 관리자로 설치:

volta install pnpm

2. 프로젝트에서 특정 pnpm 버전 고정:

volta pin pnpm@7.14.0

3. 설치된 pnpm 버전 확인:

volta list pnpm

문제 해결

Volta에서 pnpm 문제가 발생하는 경우:

1. 기능 플래그가 올바르게 설정되었는지 확인:

   • Unix에서: echo $VOLTA_FEATURE_PNPM
   • Windows에서: echo %VOLTA_FEATURE_PNPM%

2. pnpm이 올바르게 설치되었는지 확인:

   • volta list를 실행하여 pnpm이 목록에 나타나는지 확인

3. 기타 문제는 Volta GitHub 저장소에 보고해 주시기 바랍니다.