윈도우 개발 npm.ps1 파일을 로드할 수 없습니다 오류 해결하는 방법

윈도우 개발 npm.ps1 파일을 로드할 수 없습니다 오류 해결하는 방법

윈도우에서 npm을 사용하여 도구를 설치하려고 할 때, 종종 'npm.ps1 파일을 로드할 수 없습니다'라는 오류가 발생할 수 있습니다.

우선 이 오류는 주로 PowerShell의 실행 정책 때문에 발생하는데 PowerShell에서는 기본적으로 스크립트 실행을 제한하고 있어, 외부에서 다운로드한 npm 스크립트를 실행할 수 없게 됩니다.

그럼 이 오류가 발생하는 원인과 이를 해결하는 방법에 알아보도록 하겠습니다.

윈도우에서 npm을 사용해 도구를 설치하려고 할 때, 때때로 'npm.ps1 파일을 로드할 수 없습니다'라는 오류 메시지를 마주하게 됩니다. 예를 들어, npm install -g n 명령어를 실행했을 때 다음과 같은 오류가 발생할 수 있습니다.

npm : 이 시스템에서 스크립트를 실행할 수 없으므로 C:\Program Files\nodejs\npm.ps1 파일을 로드할 수 없습니다.
자세한 내용은 about_Execution_Policies(https://go.microsoft.com/fwlink/?LinkID=135170)를 참조하십시오.
위치 줄:1 문자:1
+ npm install -g n
+ ~~~
    + CategoryInfo          : 보안 오류: (:) [], PSSecurityException
    + FullyQualifiedErrorId : UnauthorizedAccess

이 오류는 PowerShell의 실행 정책(Execution Policy) 때문입니다. 기본적으로 PowerShell에서는 외부 스크립트의 실행을 제한하고 있어, npm 설치 과정에서 발생하는 스크립트를 로드할 수 없는 상황이 됩니다.

특히, Windows 환경에서는 Restricted나 AllSigned와 같은 보안 정책이 기본 설정으로 되어 있어 외부에서 받은 스크립트나 프로그램을 실행하지 못하도록 합니다.

해결 방법

이 문제를 해결하기 위해서는 PowerShell의 실행 정책을 수정해야 합니다. 아래의 단계를 따라 실행 정책을 변경해 보세요.

PowerShell 관리자 권한으로 실행

시작 메뉴에서 PowerShell을 검색한 후, Windows PowerShell을 마우스 오른쪽 버튼으로 클릭하여 관리자로 실행을 선택합니다.

먼저 현재 설정된 실행 정책을 확인후  아래 명령어를 입력하여 실행 정책을 확인할 수 있습니다.

보통 Restricted나 AllSigned로 설정되어 있을 수 있습니다.

Get-ExecutionPolicy

실행 정책 변경

npm을 원활하게 사용하기 위해서는 실행 정책을 RemoteSigned로 변경하는 것이 좋습니다. RemoteSigned는 로컬에서 작성한 스크립트는 실행할 수 있도록 허용하며, 인터넷에서 다운로드한 스크립트는 서명된 스크립트만 실행합니다. 아래 명령어를 입력하여 실행 정책을 변경합니다.명령어를 실행하면 확인 메시지가 나타납니다. Y를 입력하여 변경을 확인합니다.

Set-ExecutionPolicy RemoteSigned

변경 사항 적용 확인

실행 정책을 변경한 후, PowerShell을 새로 열고 다시 한 번 npm이 정상 작동하는지 확인합니다.

아래 명령어로 npm 버전을 확인할 수 있습니다.이 과정이 끝나면 npm을 정상적으로 사용할 수 있습니다.

npm -v

이러한 오류는 윈도우 개발 환경에서 종종 발생하지만, 실행 정책을 적절히 변경하면 손쉽게 해결할 수 있습니다.

RemoteSigned 정책으로 변경한 후에는 npm을 문제없이 사용할 수 있습니다. 이 방법을 통해 개발 도구를 설치하는 데 불편함이 없도록 설정할 수 있습니다.