Windows에 NodeJS 설치

아티클
12/20/2023

Node.js를 사용하는 개발이 처음이고 빠르게 배워 시작하고 실행하려면 다음 단계를 따라 Node.js를 직접 Windows에 설치합니다.

참고 항목

Node.js에 능숙하거나, 성능 속도와 시스템 호출 호환성이 중요하거나, Linux 작업 영역을 활용하는 Docker 컨테이너를 실행하여 Linux 및 Windows 빌드 스크립트 모두 유지 관리하지 않으려고 하거나, Bash 명령줄만 사용하려고 하면 Linux용 Windows 하위 시스템(구체적으로는 WSL 2)에 Node.js를 설치합니다.

nvm-windows, node.js 및 npm 설치

Node.js를 설치할 때 Windows 또는 WSL에 설치 여부 외에도 선택해야 할 사항이 더 있습니다. 버전이 매우 빠르게 바뀌므로 버전 관리자를 사용하는 것이 좋습니다. 작업 중인 서로 다른 프로젝트의 요구 사항에 따라 여러 Node.js 버전으로 전환해야 할 수도 있습니다. 흔히 nvm으로 불리는 노드 버전 관리자는 여러 버전의 Node.js를 설치하는 가장 인기 있는 방법이지만, Mac/Linux에만 사용할 수 있으며 Windows에서는 지원되지 않습니다. 대신 nvm-windows를 설치한 다음, 이를 사용하여 Node.js 및 npm(노드 패키지 관리자)을 설치하는 것이 좋습니다. 생각해 볼 수 있는 또 다른 버전 관리자도 있으며, 다음 섹션에서 설명하겠습니다.

Important

여러 유형을 설치하면 비정상적이고 혼란스러운 충돌이 발생할 수 있으므로, 항상 운영 체제에 설치된 기존 Node.js 또는 npm을 제거한 후 버전 관리자를 설치하는 것이 좋습니다. 여기에는 혹시 남아 있을 수 있는 기존 nodejs 설치 디렉터리(예: "C:\Program Files\nodejs")를 삭제하는 작업도 포함됩니다. NVM에서 생성한 symlink는 기존(비어 있더라도) 설치 디렉터리를 덮어쓰지 않습니다. 이전 설치를 제거하는 방법에 대한 도움말은 Windows에서 node.js를 완전히 제거하는 방법을 참조하세요.)

경고

NVM은 사용자별로 설치되고 셸당 호출되도록 설계되었습니다. 여러 빌드 에이전트가 있는 공유 개발자 상자 또는 빌드 서버용으로 설계되지 않았습니다. NVM은 바로 가기 링크를 사용하여 작동합니다. 공유 시나리오에서 nvm을 사용하면 해당 링크가 사용자의 앱 데이터 폴더를 가리키기 때문에 문제가 발생합니다. 따라서 사용자 x가 nvm use lts을(를) 실행하면 링크는 전체 상자의 노드를 앱 데이터 폴더로 가리킵니다. 사용자 y가 노드 또는 npm을 실행하는 경우 x의 사용자 계정으로 파일을 실행하도록 지시되며, npm -g의 경우 기본적으로 허용되지 않는 x의 파일을 수정합니다. 따라서 nvm은 하나의 개발자 상자에 대해서만 처방됩니다. 이는 빌드 서버에서도 마찬가지입니다. 두 빌드 에이전트가 동일한 vm/box에 있는 경우 경쟁하고 빌드에서 이상한 동작을 일으킬 수 있습니다.

windows-nvm 리포지토리의 설치 지침을 따릅니다. 설치 관리자를 사용하는 것이 좋지만 요구 사항을 더 잘 이해하고 있는 경우 수동 설치를 고려할 수 있습니다. 설치 관리자가 최신 버전의 릴리스 페이지를 가리킵니다.
최신 릴리스의 nvm-setup.zip 파일을 다운로드합니다.
다운로드한 zip 파일을 연 다음, nvm-setup.exe 파일을 엽니다.
Setup-NVM-for-Windows 설치 마법사가 nvm-windows 및 Node.js를 설치할 디렉터리를 선택하는 과정을 포함하여 설치 단계를 안내합니다.
설치가 완료되면 PowerShell(높은 관리자 권한으로 여는 것이 좋습니다)을 열고 windows-nvm을 사용하여 현재 설치된 노드 버전을 나열합니다(이 시점에서는 없어야 함). nvm ls
nvm install latest를 사용하여 Node.js 최신 릴리스를 설치합니다(최신 기능 개선 사항을 테스트하는 것이 목적이지만 LTS 버전보다 이슈가 있을 가능성이 높음).
먼저 nvm list available을 사용하여 현재 LTS 버전 번호를 확인하고 안정적인 Node.js 최신 LTS 릴리스(권장)를 설치한 다음, nvm install <version>을 사용하여(<version>을 버전 번호로 변경) LTS 버전을 설치합니다(예: nvm install 12.14.0).
nvm ls를 사용하여 설치된 노드 버전을 나열합니다. 방금 설치한 두 가지 버전이 표시될 것입니다.
필요한 Node.js 버전 번호가 설치되면 nvm use <version>을 입력하여 사용할 버전을 선택합니다(<version>을 숫자로 바꿈, 즉, nvm use 12.9.0).
프로젝트에 사용할 Node.js 버전을 변경하려면 새 프로젝트 디렉터리 mkdir NodeTest를 만들고 cd NodeTest 디렉터리로 들어간 다음, nvm use <version>을 입력하고 <version>을 사용하려는 버전 번호로 바꿉니다(예: v10.16.3`).
npm --version을 사용하여 설치된 npm 버전을 확인합니다. 이 버전 번호는 현재 Node.js 버전과 연결된 npm 버전으로 자동 변경됩니다.

대체 버전 관리자

현재 노드에 가장 많이 사용되는 버전 관리자는 windows-nvm이지만, 고려해 볼 수 있는 다음과 같은 다른 버전 관리자도 있습니다.

nvs(노드 버전 전환기)는 플랫폼 간 nvm 대안으로, VS Code와 통합할 수 있는 기능을 제공합니다.
Volta는 LinkedIn 팀의 새로운 버전 관리자로, 속도 및 플랫폼 간 지원이 향상되었다고 합니다.

windows-nvm 대신 Volta를 버전 관리자로 설치하려면 해당하는 시작 가이드의 Windows 설치 섹션으로 이동한 다음, Windows 설치 관리자를 다운로드하여 실행합니다. 그리고 설치 지침을 따릅니다.

Important

Volta를 설치하기 전에 Windows 머신에서 개발자 모드를 사용하도록 설정해야 합니다.

Volta를 사용하여 Windows에 여러 버전의 Node.js를 설치하는 방법에 대한 자세한 정보는 Volta 문서를 참조하세요.

Visual Studio Code 설치

Windows에서 Node.js를 사용하여 개발하려면 Visual Studio Code 를 설치하는 것이 좋습니다 . 도움을 위해서, Visual Studio Code의 Node.js 자습서를 참조하세요.

대체 코드 편집기

Visual Studio Code 이외의 코드 편집기나 IDE를 사용하려는 경우 Node.js 개발 환경에 적합한 코드 편집기는 다음과 같습니다.

Git 설치

다른 사람과 협업할 계획이거나 GitHub 같은 오픈 소스 사이트에 프로젝트를 호스팅할 계획인 분들을 위해 VS Code는 Git을 사용한 버전 제어를 지원합니다. VS Code의 소스 제어 탭은 모든 변경 내용을 추적하며, UI에 바로 빌드된 일반적인 Git 명령(추가, 커밋, 푸시, 끌어오기)를 포함하고 있습니다. 소스 제어 패널을 지원하려면 먼저 Git를 설치해야 합니다.

git-scm 웹 사이트 에서 Git for Windows를 다운로드하여 설치합니다.
Git 설치의 설정에 대한 일련의 질문을 하는 설치 마법사가 포함되어 있습니다. 기본 설정을 변경해야 하는 특별한 이유가 없다면 모두 기본 설정을 사용하는 것이 좋습니다.
이전에 Git를 사용한 경험이 없는 경우 GitHub 가이드를 보면 시작하는 데 도움이 될 수 있습니다.
노드 프로젝트에 .gitignore 파일을 추가하는 것이 좋습니다. 다음은 GitHub의 Node.js용 기본 gitignore 템플릿입니다.

프로덕션에 Linux용 Windows 하위 시스템 사용

Windows에서 직접 Node.js를 사용해 보면 어떤 작업을 수행할 수 있는지 알아보고 실험할 수 있습니다. 즉시 프로덕션에 사용 가능한 웹앱(일반적으로 Linux 기반 서버에 배포됨)을 빌드할 준비가 되면 Node.js 웹앱 개발에 WSL 2(Linux용 Windows 하위 시스템 버전 2)를 사용하는 것이 좋습니다. 많은 Node.js 패키지와 프레임워크는 *nix 환경을 염두에 두고 제작되며 대부분의 Node.js 앱은 Linux에 배포되므로, WSL에서 개발하면 개발 환경과 프로덕션 환경 간에 일관성을 유지할 수 있습니다. WSL 개발 환경을 설치하려면 WSL 2를 사용하여 Node.js 개발 환경 설치를 참조하세요.