MacOS NPM에서 Yarn으로 Package Manager 변경하기

npm to yarn migration

NPM으로 설정된 환경을 Yarn 패키지 매니저로 변경하는 방법입니다.

1. 구성 환경

MacOS Ventura 13
npx로 설정된 React 기본 환경
Node.js 16.20.0
NPM 8.19.4
React 18.2

 

1.1 프로젝트 유사 환경 구성

프로젝트와 비슷한 환경을 위해 라이브러리 하나를 추가했습니다.

npm install react-bootstrap bootstrap

 

2. yarn 설치

npm을 사용하여 yarn을 설치합니다.

npm install --global yarn

// yarn 설치 확인
yarn --version

※ yarn 1버전을 방식을 적용한 이유는 yarn 2버전에 호환되는 라이브러리가 없는 경우를 겪어서 yarn 1버전으로 진행하였습니다.

 

3. 프로젝트에 yarn 적용

프로젝트 폴더 내에서 Yarn 설치 커맨드 입력

cd [설치 프로젝트 경로]
yarn

 

프로젝트에 yarn 적용이 완료되었다면 아래와 같은 문구가 마지막으로 출력됩니다.

success Saved lockfile.
✨  Done in 59.15s.

 

yarn 1.7.0을 기준으로 yarn에서는 yarn.lock 파일을 사용하는데 package-lock.json 파일을 import 해올 수 있습니다.

기존에 package-lock.json 파일이 있다면 아래 커맨드를 실행해주세요.

yarn import

 

이제 yarn package manager 명령을 통해 프로젝트를 실행해보면 됩니다.

yarn start

 

 

에러 발생 리스트

* Node.js 버전 문제

다음과 같은 에러가 발생한다면 yarn에서 지원하지 않는 Node.js 버전을 사용하고 있어서 입니다.

Node.js 버전을 16버전 이상을 사용해야 합니다.

// Node.js 버전이 14버전이기 때문에 16버전으로 업그레이드 하라는 에러
error workbox-webpack-plugin@6.6.1: The engine "node" is incompatible with this module. Expected version ">=16.0.0". Got "14.18.2"
error Found incompatible module.

 

 

참고 

https://classic.yarnpkg.com/lang/en/docs/migrating-from-npm/

Yarn