Windows에 Node.js 설치

아티클
12/13/2024

이 가이드는 Windows 개발 환경에 Node.js 설치하는 데 도움이 됩니다.

Linux 환경에서 Node.js를 사용하려는 경우 WSL2(Linux용 Windows 하위 시스템)에 설치 Node.js를 참조하세요.

설치할 위치와 네이티브 Windows와 Linux(WSL 2) 환경에서 Node.js 사용하여 개발할지 여부를 결정할 때 다음을 고려합니다.

ko-KR: 기술 수준: Node.js으로 개발하는 것이 처음이고 빠르게 시작하여 학습하고자 한다면, Windows에 Node.js를 설치하세요. Windows에 Node.js 설치하고 사용하면 WSL을 사용하는 것보다 초보자에게 덜 복잡한 환경을 제공합니다.
명령줄 클라이언트 도구: PowerShell을 선호하는 경우 Windows에서 Node.js 사용합니다. Bash를 선호하는 경우 Linux에서 Node.js 사용합니다(WSL 2).
프로덕션 서버: Windows Server에 Node.js 앱을 배포하려는 경우 Windows에서 Node.js 사용합니다. Linux Server에 배포하려는 경우 Linux(WSL 2)에서 Node.js 사용합니다. WSL을 사용하면 기본 Linux 배포판(Ubuntu를 기본값으로 사용)을 설치하여 개발 환경(코드를 작성하는 위치)과 프로덕션 환경(코드가 배포된 서버) 간에 일관성을 보장할 수 있습니다.
성능 속도 및 시스템 호출 호환성: Linux 및 Windows 성능에 대한 지속적인 논쟁과 개발이 있지만 Windows 컴퓨터를 사용할 때의 핵심은 개발 프로젝트 파일을 Node.js설치한 동일한 파일 시스템에 유지하는 것입니다. Windows 파일 시스템에 Node.js 설치하는 경우 파일을 Windows 드라이브에 유지합니다(예: C:/). Linux 배포(예: Ubuntu)에 Node.js 설치하는 경우 사용 중인 배포와 연결된 Linux 파일 시스템 디렉터리에 프로젝트 파일을 유지합니다. (WSL 배포 명령줄에서 explorer.exe . 입력하여 Windows 파일 탐색기를 사용하여 디렉터리를 찾습니다.
Docker 컨테이너: Docker 컨테이너를 사용하여 Windows에서 프로젝트를 개발하려면 Windows에서 Docker Desktop을 설치하는 것이좋습니다. Linux 작업 공간에서 Docker를 사용하려면, Linux 및 Windows 빌드 스크립트를 모두 유지할 필요가 없도록 WSL 2를 사용하는 Windows용 Docker Desktop을 설정하는 방법에 대한 및을 참조하세요.

nvm-windows, node.js및 npm 설치

Windows 또는 WSL에 설치할지 여부를 선택하는 것 외에도 Node.js설치할 때 추가로 선택할 수 있습니다. 버전이 매우 빠르게 변경됨에 따라 버전 관리자를 사용하는 것이 좋습니다. 작업 중인 여러 프로젝트의 요구 사항에 따라 여러 Node.js 버전 간에 전환해야 할 수 있습니다. 일반적으로 nvm이라고 하는 노드 버전 관리자는 여러 버전의 Node.js설치하는 가장 인기 있는 방법이지만 Mac/Linux에서만 사용할 수 있으며 Windows에서는 지원되지 않습니다. 대신 nvm-windows를 설치한 다음 이를 사용하여 Node.js 및 npm(노드 패키지 관리자)을 설치하는 것이 좋습니다. 다음 섹션에서도 고려할 대체 버전 관리자가 있습니다.

중요하다

다양한 유형의 설치로 인해 이상하고 혼란스러운 충돌이 발생할 수 있으므로 버전 관리자를 설치하기 전에 운영 체제에서 Node.js 또는 npm의 기존 설치를 제거하는 것이 좋습니다. 여기에는 남아 있을 수 있는 기존 Node.js 설치 디렉터리(예: "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에 있는 경우 경쟁하고 빌드에서 이상한 동작을 일으킬 수 있습니다.

nvm-windows 리포지토리 의 설치 지침을따르십시오. 설치 관리자를 사용하는 것이 좋지만 필요에 대한 고급 이해가 있는 경우 수동 설치를 고려할 수 있습니다. 설치 관리자가 최신 버전의 릴리스 페이지를 안내합니다.
최신 릴리스에 대한 nvm-setup.zip 파일을 다운로드합니다.
다운로드한 후 zip 파일을 연 다음 nvm-setup.exe 파일을 엽니다.
Windows용 설치 마법사는 nvm-windows 및 Node.js 둘 다 설치할 디렉터리 선택을 포함하여 설치 단계를 안내합니다.

Windows용 NVM 설치 마법사
설치가 완료되면 PowerShell을 열고(관리자 권한으로 여는 것이 좋습니다.) nvm-windows를 사용하여 현재 설치된 노드 버전을 나열해 봅니다(이 시점에서는 없음이어야 함). nvm ls

노드 버전을 표시하지 않는 NVM 목록
Node.js 현재 릴리스를 설치합니다(최신 기능 향상을 테스트하기 위해 LTS 버전보다 문제가 있을 가능성이 높음). nvm install latest
먼저 현재 LTS 버전 번호가 있는 nvm list available검색하여 안정적인 Node.js 최신 LTS 릴리스를 설치합니다. nvm list available<version>(nvm install 12.14.0 숫자로 바꾸기: )로 LTS 버전 번호를 설치합니다.

사용 가능한 버전 NVM 목록
설치된 노드 버전을 나열합니다. nvm ls... 이제 방금 설치한 두 버전이 나열됩니다.

설치된 노드 버전 보여 주는 NVM 목록
필요한 Node.js 버전 번호를 설치한 후 nvm use <version>(<version> 숫자로 바꾸기, 즉 nvm use 12.9.0)을 입력하여 사용하려는 버전을 선택합니다.
프로젝트에서 사용할 Node.js 버전을 변경하려면 새 프로젝트 디렉터리 mkdir NodeTest을 만들고, 디렉터리 cd NodeTest로 이동합니다. 그런 다음 nvm use <version>를 사용하려는 버전 번호(예: v10.16.3)로 바꾸고 <version>을 입력합니다.
npm --version와 함께 설치된 npm 버전을 확인합니다. 이 버전 번호는 현재 사용 중인 Node.js에 연결된 npm 버전으로 자동으로 변경됩니다.

대체 버전 관리자

Windows용 NVM(nvm-windows)은 현재 노드에 가장 인기 있는 버전 관리자이지만 다음과 같은 대안을 고려해야 합니다.

nvs(노드 버전 전환기)는 VS Code와 통합할 수 있는 플랫폼 간 대안입니다.
Volta 향상된 속도 및 플랫폼 간 지원을 주장하는 LinkedIn 팀의 새로운 버전 관리자입니다.

버전 관리자로 Volta를 설치하려면 Volta의 시작 가이드내의 Windows 설치 섹션으로 이동한 후, 설치 지침에 따라 그들의 Windows 설치 관리자를 다운로드하여 실행합니다.

중요하다

Volta를 설치하기 전에 Windows 컴퓨터에서 개발자 모드 사용하도록 설정되어 있는지 확인해야 합니다.

Volta를 사용하여 Windows에 여러 버전의 Node.js 설치하는 방법에 대한 자세한 내용은 Volta Docs참조하세요.

Visual Studio Code 설치

Windows에서 Node.js 사용하여 개발하기 위해 Visual Studio Code 설치하는 것이 좋습니다. 도움말은 Visual Studio CodeNode.js 자습서를 참조하세요.

대체 코드 편집기

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

Git 설치

다른 사용자와 공동 작업하거나 오픈 소스 사이트(예: GitHub)에서 프로젝트를 호스트하려는 경우 VS Code는 Git버전 제어를 지원합니다. VS Code의 소스 제어 탭은 모든 변경 내용을 추적하고 UI에 기본 제공되는 일반적인 Git 명령(추가, 커밋, 푸시, 끌어오기)을 포함합니다. 먼저 소스 제어판에 전원을 공급하기 위해 Git을 설치해야 합니다.

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

Windows Server의 Node.js

Windows 서버에서 Node.js 앱을 호스트해야 하는 드문 상황이라면, 대부분의 경우역방향 프록시를 사용하게 됩니다. 이 작업을 수행하는 방법에는 두 가지가 있습니다. 1) iisnode 사용하는 직접. 이러한 리소스는 유지 관리하지 않으며 Linux 서버를 사용하여 Node.js 앱을 호스팅할 것을권장합니다.

다음을 통해 공유