volta

공식 POSIX 설치 스크립트입니다. 플랫폼을 감지하고 최신 릴리스 tarball을 다운로드해 SHA-256을 검증한 뒤 `~/.volta`에 설치하고 `~/.profile` / `~/.zshrc`에 PATH 항목을 추가합니다.

--skip-setup PATH 편집 생략; -v 자세히; --version X.Y.Z 특정 릴리스 고정

Windows의 PowerShell 설치 명령입니다. bash 스크립트와 동작은 동일하며, MSI / EXE를 다운로드하고 현재 사용자에 대해 `VOLTA_HOME`과 PATH를 설정합니다.

최신 Node.js LTS 릴리스를 설치하고 글로벌 기본값으로 설정합니다. `node`, `npm`, `npx` shim이 설치된 버전에 연결됩니다.

<version> 특정 버전 설치 (예: [email protected])

특정 Node.js 버전을 설치합니다(예: node@18, [email protected], node@latest). Volta는 설치된 모든 버전을 나란히 보관하며, `package.json`으로 고정해 전환합니다.

프로젝트의 `package.json`에 `volta.node`를 기록해, 팀원이 `volta install`을 실행할 때 이 버전을 받도록 합니다.

Node에 번들된 npm과 별개로, 이 프로젝트에서 사용할 npm 버전을 고정합니다.

Yarn(Classic 1.x)을 고정합니다. Yarn Berry(2+)를 쓰려면 `yarn` 및 `yarn@berry` 형태를 사용하세요.

pnpm을 고정해 모든 머신에서 `pnpm install`이 항상 같은 릴리스를 사용하도록 합니다.

글로벌 npm 패키지를 설치하고 해당 툴을 Volta에 등록합니다. 바이너리는 Volta shim을 통해 PATH에서 사용할 수 있게 되고, 사용자 Volta 홈에 추적됩니다.

-v 자세히; --no-progress 진행 표시 숨김

글로벌 패키지를 특정 버전으로 고정해 설치합니다. 모든 프로젝트에서 같은 컴파일러를 쓰고 싶을 때 유용합니다(예: TypeScript).

글로벌로 등록된 npm 패키지와 해당 shim을 제거합니다.

Volta가 관리하는 모든 Node / 패키지 매니저 / 글로벌 툴 버전을 나열합니다.

node; npm; yarn; pnpm; packages

설치된 Node.js 버전만 나열하고 현재 기본값을 표시합니다.

글로벌로 설치된 npm 패키지와 고정된 버전을 나열합니다.

현재 디렉터리에서 Volta가 라우팅할 바이너리의 절대 경로를 출력합니다(프로젝트별 고정을 반영).

설치하지 않고 Volta 캐시에 Node / 툴 릴리스를 미리 다운로드합니다. 오프라인 CI에 유용합니다.

--platform linux-x64 대상 플랫폼 재정의

현재 프로젝트에서 Volta가 사용할 툴체인을 통해 임의의 명령을 실행합니다. 셸 상태는 변경되지 않습니다.

프로젝트 고정을 덮어쓰는 명시적 옵션으로 명령을 실행합니다(일회성 호환성 확인에 유용).

셸 rc 파일에 Volta(PATH + `VOLTA_HOME`) 항목을 다시 추가합니다. 셸 업그레이드 후 또는 `--skip-setup`으로 설치한 뒤 실행합니다.

Volta 버전을 출력합니다.

최상위 도움말로 모든 하위 명령을 나열합니다.

자주 발생하는 환경 문제(PATH, shim 충돌, 오래된 설치, 프록시 문제)를 점검해 해결책을 제안합니다.

Volta가 도구와 shim을 저장하는 위치를 보여줍니다(POSIX 기본 `~/.volta`, Windows는 `%LOCALAPPDATA%\Volta`).

설치된 모든 툴체인을 지웁니다(POSIX). 셸 rc의 PATH 줄도 함께 제거하면 Volta를 완전히 삭제할 수 있습니다.

PowerShell에서도 동일합니다 — Volta 홈을 지운 뒤 `HKCU\Environment\Path`에서 `Volta`를 삭제합니다.