fnm 으로 npm 설치
npm (Node Package Manager) 은 Node.js 와 함께 설치됩니다. 이 가이드에서는 fnm 을 통해 npm 을 관리하는 방법을 소개합니다.
npm 과 fnm 의 관계
fnm 을 사용하여 Node.js 를 설치하면 npm 이 자동으로 포함됩니다:
bash
# Node.js 설치 (npm 자동 포함)
fnm install 20
# npm 버전 확인
npm --versionnpm 버전 확인
bash
# 현재 npm 버전 보기
npm --version
# Node.js 및 npm 버전 보기
node --version
npm --version다른 Node.js 버전은 다른 npm 버전에 해당합니다:
| Node.js | npm |
|---|---|
| 20.x | 10.x |
| 18.x | 9.x |
| 16.x | 8.x |
npm 업그레이드
npm 자체 업그레이드 사용
bash
# 최신 버전으로 업그레이드
npm install -g npm@latest
# 특정 버전으로 업그레이드
npm install -g npm@10.2.0Node.js 버전 전환
Node.js 버전을 전환하면 npm 버전도 전환됩니다:
bash
# Node.js 20 으로 전환
fnm use 20
npm --version # 출력: 10.x.x
# Node.js 18 으로 전환
fnm use 18
npm --version # 출력: 9.x.xnpm 전역 패키지 관리
전역 설치 경로 보기
bash
npm config get prefix전역 패키지 위치
fnm 이 관리하는 Node.js 전역 패키지는 다음 위치에 있습니다:
~/.fnm/node-versions/<version>/installation/lib/node_modules전역 패키지 설치
bash
# 전역 패키지 설치
npm install -g pnpm
npm install -g yarn
npm install -g typescript
# 전역 패키지 보기
npm list -g --depth=0Corepack 사용
Corepack 은 Node.js 용 패키지 관리자 관리자로 npm, yarn, pnpm 을 관리할 수 있습니다:
Corepack 활성화
bash
# Node.js 설치 시 Corepack 활성화
fnm install 20 --corepack-enabled
# 또는 환경 변수 설정
export FNM_COREPACK_ENABLED=true
fnm install 20Corepack 사용
bash
# Corepack 활성화
corepack enable
# 특정 버전의 yarn 사용
corepack prepare yarn@stable --activate
# 특정 버전의 pnpm 사용
corepack prepare pnpm@latest --activatenpm 구성
미러 구성
bash
# npm 미러 설정
npm config set registry https://registry.npmmirror.com
# 현재 구성 보기
npm config list
# 기본 미러로 복원
npm config set registry https://registry.npmjs.org일반적인 미러
| 미러 소스 | URL |
|---|---|
| npm 공식 | https://registry.npmjs.org |
| npmmirror | https://registry.npmmirror.com |
| Tencent 클라우드 | https://mirrors.cloud.tencent.com/npm/ |
다중 버전 npm 관리
npm 은 Node.js 와 함께 설치되므로 여러 npm 버전을 관리하는 가장 좋은 방법은 다음과 같습니다:
방법 1: Node.js 버전 전환
bash
# 여러 Node.js 버전 설치
fnm install 20
fnm install 18
# 버전 전환
fnm use 20 # npm 10.x
fnm use 18 # npm 9.x방법 2: npm 독립적으로 업그레이드
bash
# 현재 Node.js 버전에서 npm 업그레이드
npm install -g npm@latest일반적인 문제
npm 명령어를 찾을 수 없음
bash
# Node.js 가 설치되었는지 확인
fnm list
# 현재 사용 중인 버전 확인
fnm current
# Node.js 재설치
fnm install 20 --use전역 패키지 설치 실패
bash
# npm 캐시 정리
npm cache clean --force
# 권한 확인
ls -la ~/.fnm/node-versions/
# 재설치
npm install -g <package>npm 버전 불일치
bash
# Node.js 버전 확인
fnm current
# npm 을 기본 버전으로 재설정
fnm uninstall <version>
fnm install <version>모범 사례
1. package.json engines 사용
프로젝트에 Node.js 및 npm 버전 지정:
json
{
"engines": {
"node": ">=18.0.0",
"npm": ">=9.0.0"
}
}2. .npmrc 파일 사용
프로젝트에 .npmrc 파일 생성:
registry=https://registry.npmmirror.com
save-exact=true3. 패키지 관리자 잠금
packageManager 필드 사용:
json
{
"packageManager": "npm@10.2.0"
}관련 링크
- Node.js 설치 - Node.js 설치
- 버전 관리 - 버전 관리 가이드
- 명령어 참조 - 모든 명령어 상세 정보