[Ubuntu 24.04] Zsh 환경 Node.js 및 pnpm 설치 가이드

Ubuntu 24.04 환경에서 Zsh를 사용하는 개발자를 위한 최적의 Node.js 개발 환경 구축 방법을 정리합니다. nvm을 통해 버전을 관리하고, Corepack을 사용하여 pnpm을 설치하는 가장 권장되는 방식입니다.

시스템 업데이트 및 필수 패키지 설치

먼저 터미널을 열고 패키지 리스트를 업데이트한 뒤, 설치 스크립트 실행에 필요한 curl을 설치합니다.

sudo apt update && sudo apt install -y curl

---

nvm(Node Version Manager) 설치

Node.js 버전을 쉽게 교체할 수 있게 해주는 nvm을 설치합니다. (최신 안정판 v0.40.4 기준)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

---

Zsh 환경 변수 설정

Zsh 환경에서 nvm 명령어를 바로 사용할 수 있도록 ~/.zshrc 파일에 경로를 추가해야 합니다.

# zshrc 파일 편집
nano ~/.zshrc

파일 가장 하단에 아래 내용을 복사하여 붙여넣습니다.

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"  # nvm 로드
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # nvm completion 로드

수정된 내용을 시스템에 적용합니다.

source ~/.zshrc

---

Node.js LTS 버전 설치

이제 nvm을 사용하여 안정적인 최신 LTS 버전을 설치합니다.

- 최신 LTS(안정화) 버전 설치

nvm install --lts

- 설치 확인

node -v
npm -v

---

pnpm 설치 (Corepack 방식)

Node.js 16.13 버전부터 포함된 Corepack을 활용하면 별도의 설치 스크립트 없이 pnpm을 활성화할 수 있습니다.

- Corepack 활성화

corepack enable

- 최신 버전의 pnpm 준비 및 활성화

corepack prepare pnpm@latest --activate

- 설치 확인

pnpm -v

---

정리

1. 유연성: 프로젝트마다 필요한 Node.js 버전이 다를 때 nvm use 명령으로 즉시 전환이 가능합니다.
2. 권한 관리: npm install -g 시 sudo 권한을 빌리지 않아도 되므로 보안상 안전하며 관리가 편리합니다.
3. Corepack 최적화: 별도의 패키지 매니저를 전역(Global) 설치하는 대신, Node.js 자체 기능을 이용해 pnpm을 관리하므로 환경이 매우 깔끔합니다.