npm 실행 정책 오류 해결 방법

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

개발 툴

대상자

• 대상자: Node.js 개발자, 프론트엔드/백엔드 개발자
• 난이도: 중간 (시스템 설정 변경 필요)

핵심 요약

• npm install 오류 원인: PowerShell의 실행 정책(ExecutionPolicy) 설정 문제
• 해결 방법: Set-ExecutionPolicy RemoteSigned 명령어로 정책 변경
• 중요 명령어: Get-ExecutionPolicy, Set-ExecutionPolicy Restricted (복구 시)

섹션별 세부 요약

1. PowerShell 실행 권한 설정

• 관리자 권한으로 실행:

- 시작 메뉴에서 PowerShell 검색 후 오른쪽 클릭 → "관리자로 실행"

• 권한 부족 시 오류 발생: 시스템 보안 정책 차단

2. 실행 정책 변경 방법

• 명령어 실행:

```powershell

Set-ExecutionPolicy RemoteSigned

```

• 변경 확인:

```powershell

Get-ExecutionPolicy

```

• 결과: RemoteSigned 정책 적용 시 로컬/원격 서명 스크립트 실행 허용

3. npm 명령어 재실행

• Vite 프로젝트 생성 시 예시:

```bash

npm create vite@latest

```

• 성공 조건: 실행 정책 변경 후 명령어 정상 수행

4. 정책 복구 (선택 사항)

• 기본 정책 복원:

```powershell

Set-ExecutionPolicy Restricted

```

• 주의: 보안 위험 방지를 위해 신뢰할 수 있는 스크립트만 실행

결론

• 핵심 팁: Set-ExecutionPolicy RemoteSigned 명령어로 정책 변경 후 npm install 재실행
• 보안 강화: 사용 후 Restricted로 복구하고, 원격 스크립트 실행 시 서명 검증 필수