윈도우 개발환경 설치 node.js

npm이 설치되지 않은 것이 아니라, 대부분은 Node.js 가 제대로 설치되지 않았거나 PATH 연결이 안 된 경우가 많습니다.

React를 사용하려면:

Node.js + npm

이 반드시 필요합니다.

참고로 npm은 Node.js를 설치하면 자동으로 함께 설치됩니다.

---

1. 현재 상태 확인하기

VSCode 터미널 또는 PowerShell에서 아래 명령어 입력해보세요.

Node 확인

node -v

---

npm 확인

npm -v

---

정상인 경우

예시:

v22.15.0

10.9.2

---

오류가 나온다면

예시:

'node' is not recognized

또는

'npm' is not recognized

이라면:

• Node.js 미설치
• PATH 등록 실패

상태입니다.

---

2. Node.js 다시 설치하기 (권장)

아래 공식 사이트 접속:

Node.js 공식 사이트

---

3. 반드시 LTS 버전 설치

추천:

LTS

버전 다운로드

---

4. 설치 중 매우 중요한 체크

설치 화면에서 반드시 아래 옵션 확인:

Add to PATH

체크되어 있어야 합니다.

이 설정이 안 되면 npm 명령어가 동작하지 않습니다.

---

5. 설치 완료 후 꼭 해야 하는 것

설치 후:

✅ VSCode 완전히 종료
✅ PowerShell 종료
✅ 다시 실행

해야 환경변수가 적용됩니다.

---

6. 다시 확인하기

다시 터미널 열고:

node -v

npm -v

입력

---

7. npm 정상 설치 후 React 설치

이제 React 프로젝트 생성 가능:

npx create-vite@latest

---

8. 그래도 npm이 안 되는 경우

아래 명령 입력:

where node

그리고:

where npm

정상이라면 경로가 출력됩니다.

예시:

C:\Program Files\nodejs\node.exe

C:\Program Files\nodejs\npm

---

9. PATH 수동 등록 방법 (최후 방법)

그래도 안 되면:

Windows 검색:

환경 변수 편집

열기

---

환경 변수 → Path → 편집

아래 경로 추가:

C:\Program Files\nodejs\

저장 후 PC 재부팅

---

가장 추천하는 해결 방법

초보자 기준 가장 빠른 해결 방법:

1. Node.js 삭제
2. PC 재부팅
3. LTS 버전 재설치
4. Add to PATH 체크
5. VSCode 재실행

이 방법으로 대부분 해결됩니다.

---

다음 단계

npm 설치가 완료되면 이어서:

npx create-vite@latest

로 React 프로젝트를 생성하면 됩니다.

 

 

지금 오류는 npm이 설치되지 않은 것이 아니라, PowerShell의 보안 정책 때문에 npm 실행이 차단된 상태입니다.

화면의 핵심 오류:

npm : 이 시스템에서 스크립트를 실행할 수 없으므로

그리고:

PSSecurityException

이 메시지가 중요합니다.

즉:

✅ Node.js 설치 정상
✅ npm 설치 정상
❌ PowerShell 실행 정책 때문에 차단

상태입니다.

---

가장 쉬운 해결 방법 (추천)

PowerShell에서 아래 명령어를 그대로 입력하세요.

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

---

실행 후 나오는 질문

아래처럼 나옵니다.

변경하시겠습니까?
[Y] Yes
[N] No

여기서:

Y

입력 후 Enter

---

그 다음 PowerShell 완전히 종료

현재 창 닫기

다시 VSCode 또는 PowerShell 실행

---

다시 확인

다시 아래 명령 실행:

npm -v

---

정상이라면

예시:

10.8.2

처럼 버전이 출력됩니다.

---

왜 이런 문제가 생기나요?

Windows PowerShell은 보안 때문에 .ps1 스크립트 실행을 막는 경우가 있습니다.

npm은 내부적으로:

npm.ps1

파일을 실행하는데, 현재 정책이 이를 차단한 것입니다.

---

보안상 괜찮나요?

아래 명령은:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

현재 사용자 계정에만 적용됩니다.

그리고:

• 로컬 스크립트 허용
• 인터넷 다운로드 스크립트는 서명 필요

정책이라 일반 개발 환경에서 가장 많이 사용하는 안전한 설정입니다.

---

설정 완료 후 다음 단계

npm이 정상 동작하면 이어서 React 설치:

npx create-vite@latest

실행하면 됩니다.

---

추가 팁 (추천)

VSCode에서 PowerShell 대신 Git Bash 사용하면 이런 오류가 거의 없습니다.

터미널 변경 방법:

Terminal → New Terminal

우측 상단 ▼ 클릭

선택:

Git Bash

개발자들은 보통 Git Bash 사용을 많이 추천합니다.