Skip to content

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 --version

npm 버전 확인

bash
# 현재 npm 버전 보기
npm --version

# Node.js 및 npm 버전 보기
node --version
npm --version

다른 Node.js 버전은 다른 npm 버전에 해당합니다:

Node.jsnpm
20.x10.x
18.x9.x
16.x8.x

npm 업그레이드

npm 자체 업그레이드 사용

bash
# 최신 버전으로 업그레이드
npm install -g npm@latest

# 특정 버전으로 업그레이드
npm install -g npm@10.2.0

Node.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.x

npm 전역 패키지 관리

전역 설치 경로 보기

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=0

Corepack 사용

Corepack 은 Node.js 용 패키지 관리자 관리자로 npm, yarn, pnpm 을 관리할 수 있습니다:

Corepack 활성화

bash
# Node.js 설치 시 Corepack 활성화
fnm install 20 --corepack-enabled

# 또는 환경 변수 설정
export FNM_COREPACK_ENABLED=true
fnm install 20

Corepack 사용

bash
# Corepack 활성화
corepack enable

# 특정 버전의 yarn 사용
corepack prepare yarn@stable --activate

# 특정 버전의 pnpm 사용
corepack prepare pnpm@latest --activate

npm 구성

미러 구성

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
npmmirrorhttps://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=true

3. 패키지 관리자 잠금

packageManager 필드 사용:

json
{
  "packageManager": "npm@10.2.0"
}

관련 링크