다른 사람들도 쉽게 알 수 있게 노드 버전을 세팅해보세요

목차

· nvm 설치로 노드 버전 관리 간소화하기

· .nvmrc로 프로젝트 노드 버전 관리하기

· windows 환경에서 .nvmrc 세팅 시 주의할 점

---

항상 사이드 프로젝트에 중간 합류를 하게 되면 개발 환경 세팅으로 인해 골머리를 앓는 경우가 있는데요, 이때 개발자의 글로벌 노드 버젼과 프로젝트 자체의 노드 버젼이 달라서 프로젝트가 실행되지 않는 경우가 있는데 프로젝트를 생성한 사람에게 노드 버젼을 물어보는 경우가 생겨요. 프로젝트에서 버전 문제가 발생하여 실행을 못한다거나, 일부 라이브러리를 사용하지 못했던 경험이 있으시지 않으신가요?

 

예전 리액트 프로젝트를 처음 접했을 때, 시니어 개발자 분이 .nvmrc 파일을 계속 생성하시는 것을 보고 "저 파일은 대체 뭘까.." 라는 생각을 했었는데, 실제로 여러 개발자들과 협업 시에 "나만 잘 아는 코드가 아닌 다른 사람들도 잘 알 수 있는 코드 및 프로젝트" 를 만드는 것이 중요하다는 것을 알게 되었는데요.

 

README 파일에 버전 명을 적어두는 것도 물론 좋은 방법일 수 있겠지만, 노드 버젼을 확인하고 만약 없다면 설치하는 과정이 추가되겠죠. 이를 조금 더 편하게 하고자 .nvmrc 라는 파일을 통해 쉽게 프로젝트의 노드 버젼을 관리할 수 있어요. 프로젝트의 루트 경로에 .nvmrc 파일을 생성해요, 그리고 해당 파일에 버전 명을 기재해요. 기재한 버전 명은 이제 프로젝트의 대표 노드 버젼으로 세팅이 되었다고 생각을 해주셔도 좋아요. 우선 해당 포스팅에서 가이드대로 실행을 하기 위해서 사전 조건 하나가 필요해요.

 

nvm 설치로 노드 버젼 관리 간소화하기

nvm이란 내 컴퓨터에 다양한 버전의 node.js 를 설치할 수 있게 해주고, 다양한 node.js 버전을 쉽게 관리할 수 있도록 도와줘요.

use 커맨드를 통해 사용할 node 버전을 선택할 수 있고, 보다 간편하게 스위칭을 할 수 있어요.

default 옵션을 통해 나의 기본 node 버전을 설정할 수 있고, 설치한 버전들의 전체 리스트를 확인하거나 필요 없는 버전을 삭제할 수 있어요. Ruby on Rails의 rvm, rbenv나 파이썬의 pyenv와 같은 역할을 하기도 합니다.

 

.nvmrc 파일을 사용하기 위해서는 nvm 설치가 필수적이니 사전 설치가 되어있지 않은 분들은 아래 공식 깃허브에서 확인할 수 있어요

GitHub - nvm-sh/nvm: Node Version Manager - POSIX-compliant bash script to manage multiple active node.js versions

.nvmrc로 프로젝트 노드 버전 관리하기

v18.7.0

이렇게 .nvmrc 파일이 생성이 되었다면, 명령어 하나로 바로 노드 버젼의 싱크를 연동할 수 있습니다.

$ nvm use

// 만약 해당 프로젝트에서 내가 없는 노드 버젼이라면 아래 명령어 하나면 설치가 가능해요
$ nvm install

windows 환경에서 .nvmrc 세팅 시 주의할 점

Unfortunately nvm use on Windows does not change the node version to that specified in the .nvmrc file as its not supported on nvm for Windows: coreybutler/nvm-windows#388
So the easiest solution to this is to use a simple Powershell command that performs an approximation of the command as follows: nvm use $(Get-Content .nvmrc).replace( 'v', '' );

 

보통 nvm은 명령어 실행 시, 명령어를 실행한 경로에 있는 .nvmrc를 참조하여 명령어를 실행해요, 다만 윈도우의 경우에는 nvm use와 같은 명령어가 실행이 되지 않아요, 우리가 사용하는 일반적인 windows에서는 사용이 까다로우며, 리눅스를 설치하거나 이외의 방법으로 사용을 해야한다는 단점이 있어요, 다만 nvm-windows 를 통해 쉽게 사용을 할 수 있으니 참고하여 윈도우 환경에서도 nvm use를 사용할 수도록 설치해보는 것도 추천드려요.

NVM으로 Windows 환경에서 Node 버전 관리하기