fnm 으로 Node.js 설치
fnm 은 Node.js 버전 설치 및 관리를 간단하고 빠르게 만듭니다. 이 가이드에서는 fnm 을 사용하여 Node.js 를 설치하는 방법을 자세히 설명합니다.
빠른 시작
최신 LTS 버전 설치
bash
fnm install --lts최신 버전 설치
bash
fnm install --latest특정 버전 설치
bash
fnm install 20
fnm install 18.17.0설치 방법 설명
LTS 버전 설치
Node.js LTS (Long Term Support) 버전은 프로덕션 환경에 권장됩니다:
bash
# 최신 LTS 버전 설치
fnm install --lts
# 특정 LTS 버전 설치
fnm install lts/iron # Node.js 20.x
fnm install lts/hydrogen # Node.js 18.x
fnm install lts/gallium # Node.js 16.xLTS 버전 코드명:
| 코드명 | 버전 | 상태 |
|---|---|---|
| Iron | 20.x | 활성 LTS |
| Hydrogen | 18.x | 유지보수 |
| Gallium | 16.x | 수명 종료 |
특정 버전 설치
bash
# 주요 버전 설치 (자동으로 최신 마이너 버전 선택)
fnm install 20
# 특정 버전 설치
fnm install 20.10.0
# 이전 버전 설치
fnm install 14.21.3버전 파일을 사용하여 설치
프로젝트 디렉토리에 .node-version 또는 .nvmrc 파일을 생성합니다:
bash
# .node-version 파일 생성
echo "20" > .node-version
# fnm 이 자동으로 읽고 설치합니다
fnm install설치 후 사용
설치된 버전으로 전환
bash
# 특정 버전 사용
fnm use 20
# 버전이 설치되지 않은 경우 자동 설치 후 사용
fnm use 18 --install-if-missing기본 버전 설정
bash
# 기본 버전 설정
fnm default 20
# 현재 기본 버전 보기
fnm default설치 후 즉시 사용
bash
# 설치 후 즉시 버전으로 전환
fnm install 20 --use사용 가능한 버전 보기
원격 버전 보기
bash
# 사용 가능한 모든 버전 나열
fnm list-remote
# LTS 버전만 나열
fnm list-remote --lts
# 특정 버전 필터링
fnm list-remote --filter=18
# 최신 버전 보기
fnm list-remote --latest로컬에 설치된 버전 보기
bash
fnm list출력 예제:
* v20.10.0 default
v18.19.0
v16.20.2빠른 다운로드를 위한 미러 사용
중국 본토에서는 미러를 사용하여 다운로드 속도를 높일 수 있습니다:
bash
# 미러 환경 변수 설정
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
# 또는 설치 시 지정
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node일반적인 미러:
| 미러 소스 | URL |
|---|---|
| npmmirror | https://npmmirror.com/mirrors/node |
| 칭화대학교 | https://mirrors.tuna.tsinghua.edu.cn/nodejs-release |
Corepack 지원
fnm 은 Yarn 과 pnpm 을 자동으로 활성화할 수 있는 Corepack 을 지원합니다:
bash
# 설치 시 Corepack 활성화
fnm install 20 --corepack-enabled
# 또는 환경 변수 설정
export FNM_COREPACK_ENABLED=true
fnm install 20버전 관리 모범 사례
프로젝트 수준 버전 관리
프로젝트 루트에 .node-version 파일을 생성합니다:
bash
# 주요 버전 지정
echo "20" > .node-version
# 또는 정확한 버전 지정
echo "20.10.0" > .node-version--use-on-cd 옵션과 결합하여 디렉토리 진입 시 자동으로 버전을 전환합니다:
bash
# Shell 구성에 추가
eval "$(fnm env --use-on-cd)"다중 버전 개발
bash
# 여러 버전 설치
fnm install 20
fnm install 18
fnm install 16
# 다른 프로젝트 간 전환
cd project-a && fnm use 20
cd project-b && fnm use 18별칭 사용
bash
# 별칭 설정
fnm alias 20 default
fnm alias 18 legacy
# 별칭을 사용하여 전환
fnm use default
fnm use legacy일반적인 문제
설치 실패
설치가 실패하면 다음을 확인하세요:
- 네트워크 연결이 정상인지
- 미러 구성이 필요한지
- 디스크 공간이 충분한지
bash
# 미러 사용하여 재시도
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node버전 전환이 작동하지 않음
Shell 이 올바르게 구성되었는지 확인합니다:
bash
# 현재 버전 확인
fnm current
# node 경로 확인
which node오래된 버전 정리
bash
# 설치된 버전 보기
fnm list
# 필요 없는 버전 제거
fnm uninstall 16.20.2