빠른 시작

Volta 설치

Unix 설치

대부분의 Unix 시스템(macOS 포함)에서 한 번의 명령으로 Volta를 설치할 수 있습니다:

curl https://get.volta.sh | bash

bash, zsh, fish의 경우 이 설치 프로그램이 콘솔 시작 스크립트를 자동으로 업데이트합니다. 콘솔 시작 스크립트 수정을 방지하려면 Volta 설정 건너뛰기를 참조하세요. 셸을 수동으로 구성하여 Volta를 사용하려면 콘솔 시작 스크립트를 편집하세요:

• VOLTA_HOME 변수를 $HOME/.volta로 설정
• $VOLTA_HOME/bin을 PATH 변수의 시작 부분에 추가

Windows 설치

Windows의 경우 winget을 사용하여 Volta를 설치하는 것이 권장됩니다:

winget install Volta.Volta

원하는 경우 설치 프로그램을 직접 다운로드하여 수동으로 실행해 Volta를 설치할 수도 있습니다.

Windows Linux 서브시스템

Windows Linux 서브시스템에서 Volta를 사용하는 경우 위의 Unix 설치 가이드를 따르세요.

수동 설치

Volta를 수동으로 설치하려면 아래 표에서 운영 체제에 적합한 패키지를 다운로드할 수 있습니다:

플랫폼	패키지 및 설치 지침
Windows x86_64	volta-2.0.2-windows-x86_64.msi MSI 파일을 더블클릭하고 설치 마법사를 따라하세요. 설치 프로그램이 자동으로 Volta를 PATH에 추가합니다.
Windows ARM64	volta-2.0.2-windows-arm64.msi MSI 파일을 더블클릭하고 설치 마법사를 따라하세요. 설치 프로그램이 자동으로 Volta를 PATH에 추가합니다.
Windows x86_64 (ZIP)	volta-2.0.2-windows.zip ZIP 파일을 선택한 위치에 압축 해제하세요. 압축 해제된 디렉토리를 PATH 환경 변수에 추가하세요.
Windows ARM64 (ZIP)	volta-2.0.2-windows-arm64.zip ZIP 파일을 선택한 위치에 압축 해제하세요. 압축 해제된 디렉토리를 PATH 환경 변수에 추가하세요.
macOS x86_64/ARM64	volta-2.0.2-macos.tar.gz tarball을 압축 해제하고 포함된 설치 스크립트를 실행하세요: tar xzf volta-2.0.2-macos.tar.gz && ./volta-2.0.2-macos/install.sh
Linux x86_64	volta-2.0.2-linux.tar.gz tarball을 압축 해제하고 포함된 설치 스크립트를 실행하세요: tar xzf volta-2.0.2-linux.tar.gz && ./volta-2.0.2-linux/install.sh
Linux ARM	volta-2.0.2-linux-arm.tar.gz tarball을 압축 해제하고 포함된 설치 스크립트를 실행하세요: tar xzf volta-2.0.2-linux-arm.tar.gz && ./volta-2.0.2-linux-arm/install.sh

Windows 수동 설치 단계

1. 시스템 아키텍처(x86_64 또는 ARM64)에 해당하는 MSI 설치 프로그램을 다운로드
2. 다운로드한 파일을 더블클릭하여 설치 프로그램 실행
3. 설치 마법사 프롬프트를 따라 진행
4. 설치 프로그램이 자동으로 Volta를 시스템 PATH에 추가
5. 새로운 명령 프롬프트 또는 PowerShell 창을 열어 Volta 사용 시작

ZIP 설치 방법:

1. 시스템 아키텍처에 해당하는 ZIP 파일 다운로드
2. ZIP 파일을 선택한 디렉토리에 압축 해제 (예: C:\Program Files\Volta)
3. 압축 해제된 디렉토리를 시스템 PATH 환경 변수에 추가
4. 새로운 명령 프롬프트 또는 PowerShell 창을 열어 Volta 사용 시작

macOS 수동 설치 단계

1. macOS tarball 다운로드
2. 터미널을 열고 다운로드 위치로 이동
3. tarball을 압축 해제하고 설치 스크립트 실행:

   tar xzf volta-2.0.2-macos.tar.gz
   ./volta-2.0.2-macos/install.sh

4. 설치 스크립트는 다음 작업을 수행합니다:
   • Volta 바이너리를 ~/.volta/bin에 배치
   • 셸 구성 프로필을 업데이트하여 Volta를 PATH에 추가
5. 터미널을 재시작하거나 source ~/.bashrc (또는 해당 셸 구성 파일) 실행

Linux 수동 설치 단계

1. 시스템 아키텍처(x86_64 또는 ARM)에 해당하는 Linux tarball 다운로드
2. 터미널을 열고 다운로드 위치로 이동
3. tarball을 압축 해제하고 설치 스크립트 실행:

   tar xzf volta-2.0.2-linux.tar.gz
   ./volta-2.0.2-linux/install.sh

4. 설치 스크립트는 다음 작업을 수행합니다:
   • Volta 바이너리를 ~/.volta/bin에 배치
   • 셸 구성 프로필을 업데이트하여 Volta를 PATH에 추가
5. 터미널을 재시작하거나 source ~/.bashrc (또는 해당 셸 구성 파일) 실행

기본 Node 버전 선택

이는 Volta가 고정된 버전이 없는 프로젝트 외부에서 모든 곳에서 사용하는 버전입니다.

특정 버전의 Node를 선택하려면 다음을 실행하세요:

volta install node@22.5.1

또는 최신 LTS 버전을 사용하려면 다음을 실행하세요:

volta install node

Volta로 프로젝트 관리

프로젝트에서 Volta를 사용하는 것은 간단합니다. 다음을 실행하기만 하면 됩니다:

volta pin node@16

이렇게 하면 package.json 파일에 volta 섹션이 추가되어 모든 프로젝트 구성원이 동일한 버전의 Node.js를 사용하도록 보장됩니다.

패키지 관리자도 고정할 수 있습니다:

volta pin npm@8

이렇게 하면 프로젝트에서 npm을 실행할 때마다 Volta가 지정된 버전을 사용하도록 보장합니다.