Skip to content

volta setup

volta setup 명령은 Volta 심 디렉토리를 포함하도록 현재 사용자의 PATH를 (플랫폼별 방식으로) 수정하여 Volta를 활성화합니다. 구문은 다음과 같습니다:

bash
현재 사용자에 대해 Volta 활성화

사용법:
    volta setup [FLAGS]

플래그:
        --verbose    자세한 진단 활성화
        --quiet      불필요한 출력 방지
    -h, --help       도움말 정보 출력

Unix 설정

Unix 시스템(macOS 및 Linux)에서 volta setup은 다음 목록을 사용하여 구성 파일 스크립트를 검색합니다:

  • ~/.profile
  • ~/.bash_profile
  • ~/.bashrc
  • ~/.zshrc
  • ~/.config/fish/config.fish
  • PROFILE 환경 변수의 값

존재하는 파일에 대해 volta setup은 다음 줄을 포함하도록 수정합니다:

  1. VOLTA_HOME 환경 변수 정의 (일반적으로 ~/.volta로 설정)
  2. PATH 환경 변수에 $VOLTA_HOME/bin 추가

현재 셸의 구성 파일($SHELL 환경 변수를 사용하여 감지)이 존재하지 않으면 가능한 경우 적절한 내용으로 생성합니다.

Windows 설정

Windows에서 volta setup은 심 디렉토리(%LOCALAPPDATA%\Volta\bin)를 포함하도록 사용자 Path 환경 변수를 수정합니다. 이를 통해 모든 명령 프롬프트에서 Volta 명령을 사용할 수 있습니다.

예제

기본 설정

bash
# 설정 프로세스 실행
volta setup

이렇게 하면 셸 구성 파일이 업데이트되고 셸에서 Volta를 사용할 수 있게 됩니다.

자동 설정

bash
# 최소한의 출력으로 설정 실행
volta setup --quiet

사용 시기

volta setup 명령은 여러 상황에서 유용합니다:

  1. 새로 설치한 후: Volta를 처음 설치한 후 실행
  2. 셸 구성 삭제 후: 셸 구성 파일을 수동으로 편집하고 Volta의 구성을 제거한 경우
  3. 새 사용자: 시스템에서 새 사용자를 위해 Volta를 설정할 때
  4. 셸 변경 후: 다른 셸로 전환한 경우

설정이 구성 파일에 추가하는 내용

bash/zsh/sh의 경우 volta setup은 다음과 같은 줄을 추가합니다:

bash
export VOLTA_HOME="$HOME/.volta"
export PATH="$VOLTA_HOME/bin:$PATH"

fish 셸의 경우 다음을 추가합니다:

fish
set -gx VOLTA_HOME "$HOME/.volta"
set -gx PATH "$VOLTA_HOME/bin" $PATH

수동 설정

volta setup을 사용하지 않으려면 수동으로 PATH에 Volta를 추가할 수 있습니다:

  1. Volta 홈 디렉토리 생성 (Unix에서는 기본적으로 ~/.volta, Windows에서는 %LOCALAPPDATA%\Volta)
  2. PATH 환경 변수에 bin 디렉토리 추가
  3. 셸 재로드 또는 터미널 재시작

문제 해결

volta setup 실행 후 Volta를 사용할 수 없는 경우:

  1. 새 터미널 창을 열었는지 확인
  2. Volta의 bin 디렉토리가 PATH에 있는지 확인 (Unix에서는 echo $PATH, Windows에서는 echo %PATH% 사용)
  3. Volta 홈 디렉토리가 존재하는지 확인
  4. Unix 시스템의 경우 셸 구성 파일이 올바르게 수정되었는지 확인