Coding/Python

VSCode Python 가상환경 오류 해결하기 - PowerShell 실행 정책 변경

포스트it 2025. 11. 23. 17:05

728x90

VSCode Python 가상환경 오류 해결하기 - PowerShell 실행 정책 변경

이런 에러 보셨나요?

VSCode에서 Python 가상환경을 활성화하려고 하는데 이런 빨간 에러 메시지가 나타난다면?

이 시스템에서 스크립트를 실행할 수 없으므로 C:\Users\user\PycharmProjects\judge-ai\.venv\Scripts\Activate.ps1 파일을 로드할 수 없습니다.

딱 5분이면 해결할 수 있습니다! 😊

왜 이런 오류가 발생할까?

Windows는 보안을 위해 기본적으로 외부 스크립트 실행을 차단합니다. 이것을 "실행 정책(Execution Policy)" 이라고 해요.

Python 가상환경을 활성화하는 Activate.ps1 파일도 스크립트이기 때문에 막히는 거죠.

이 문제를 해결하려면 PowerShell의 실행 정책을 변경해야 합니다.

해결 방법 (단계별 가이드)

1단계: PowerShell을 관리자 권한으로 실행하기

Windows 10/11 방법

방법 A - 검색 사용

키보드에서 Windows 키를 누르세요
"PowerShell" 또는 "파워셸"을 입력하세요
검색 결과에 "Windows PowerShell" 이 나타납니다
우클릭(마우스 오른쪽 버튼)을 누르세요
"관리자 권한으로 실행" 을 클릭하세요

방법 B - 시작 메뉴 사용

Windows 키를 누르세요
앱 목록에서 "Windows PowerShell" 폴더를 찾으세요
"Windows PowerShell" 우클릭
"관리자 권한으로 실행" 클릭

💡 Tip

관리자 권한으로 실행하면 파란색 PowerShell 창의 제목에 "관리자: Windows PowerShell" 이라고 표시됩니다.

2단계: 실행 정책 변경하기

파란색 PowerShell 창이 열렸다면, 다음 명령어를 정확히 입력하세요:

Set-ExecutionPolicy RemoteSigned

입력 후 Enter 키를 누르세요.

3단계: 승인하기

아래와 같은 확인 메시지가 나타납니다:

실행 정책 변경
실행 정책을 통해 신뢰할 수 없는 스크립트를 차단할 수 있습니다. 실행 정책을 변경하면 
about_Execution_Policies 도움말 항목(https://go.microsoft.com/fwlink/?LinkID=135170)에 설명된 
보안 위험에 노출될 수 있습니다. 실행 정책을 변경하시겠습니까?
[Y] 예(Y)  [A] 모두 예(A)  [N] 아니요(N)  [L] 모두 아니요(L)  [S] 일시 중단(S)  [?] 도움말

Y를 입력하고 Enter를 누르세요.

4단계: 완료 확인

에러 메시지 없이 다시 명령 프롬프트(PS C:\Windows\System32>)로 돌아왔다면 성공입니다! 🎉

PowerShell 창을 닫아도 됩니다.

5단계: VSCode에서 테스트하기

이제 VSCode로 돌아가서 테스트해봅시다.

VSCode를 열어주세요
터미널을 새로 열기 (Ctrl + `` 또는 상단 메뉴 > Terminal > New Terminal)
다음 명령어를 입력하세요:

.\.venv\Scripts\Activate.ps1

또는 프로젝트 경로에 따라:

& c:/Users/user/PycharmProjects/judge-ai/.venv/Scripts/Activate.ps1

터미널 좌측에 (.venv) 표시가 나타나면 성공입니다!

(.venv) PS C:\Users\user\PycharmProjects\judge-ai>

잘 안 될 때 체크리스트

❌ 여전히 같은 에러가 나온다면?

체크 1: 정말 관리자 권한으로 실행했나요?

PowerShell 창 제목에 "관리자"라는 단어가 있어야 합니다
없다면 PowerShell을 닫고 1단계부터 다시 시도하세요

체크 2: 명령어를 정확히 입력했나요?

대소문자는 상관없지만, 띄어쓰기와 하이픈(-)은 정확해야 합니다
복사-붙여넣기를 활용하세요:
```
Set-ExecutionPolicy RemoteSigned
```

체크 3: VSCode를 재시작했나요?

설정 변경 후 VSCode를 완전히 종료했다가 다시 실행해보세요

체크 4: 가상환경이 실제로 존재하나요?

VSCode 터미널에서 확인:
```
dir .venv\Scripts
```
Activate.ps1 파일이 목록에 보여야 합니다

RemoteSigned가 뭔가요? (안전한가요?)

실행 정책 종류

Windows PowerShell에는 여러 보안 수준이 있습니다:

정책	설명	안전도
Restricted	모든 스크립트 차단 (기본값)	가장 안전
RemoteSigned	인터넷에서 받은 스크립트만 서명 확인	안전 ✅
AllSigned	모든 스크립트 서명 필요	매우 안전
Unrestricted	모든 스크립트 실행 허용	위험 ⚠️

RemoteSigned는 안전합니다!

✅ 본인이 만든 스크립트: 자유롭게 실행 가능
✅ 로컬 파일: 제한 없음
⚠️ 인터넷에서 다운받은 스크립트: 디지털 서명 확인

즉, Python 가상환경처럼 내 컴퓨터에서 만든 파일은 문제없이 실행되고, 외부에서 받은 의심스러운 파일은 여전히 보호받습니다.

개발자들이 가장 많이 사용하는 안전한 설정입니다. 👍

실행 정책 확인하는 방법

현재 설정된 실행 정책을 확인하고 싶다면:

Get-ExecutionPolicy

결과로 RemoteSigned가 나오면 제대로 설정된 것입니다.

다시 원래대로 되돌리고 싶다면?

나중에 보안 설정을 원래대로 되돌리고 싶다면:

PowerShell을 다시 관리자 권한으로 실행
다음 명령어 입력:
```
Set-ExecutionPolicy Restricted
```
Y 입력 후 Enter

하지만 Python 개발을 계속한다면 RemoteSigned 상태로 두는 것을 권장합니다.

한 번만 설정하면 끝!

이 방법의 장점은 단 한 번만 설정하면 됩니다.

✅ 컴퓨터를 재부팅해도 유지됨
✅ VSCode를 껐다 켜도 유지됨
✅ 다른 Python 프로젝트에서도 사용 가능
✅ 터미널을 새로 열 때마다 재설정할 필요 없음

자주 묻는 질문 (FAQ)

Q1. 회사 컴퓨터인데 관리자 권한이 없어요

A. IT 부서에 요청하거나, 대신 다음 방법을 사용해보세요:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

이 명령어는 관리자 권한이 필요 없으며, 현재 사용자에게만 적용됩니다.

Q2. "관리자 권한으로 실행" 메뉴가 안 보여요

A. 다음을 시도해보세요:

Ctrl + Shift + Esc로 작업 관리자 실행
파일 > 새 작업 실행
powershell 입력
"관리 권한으로 이 작업 만들기" 체크
확인

Q3. 이 설정이 다른 프로그램에 영향을 주나요?

A. 아니요. 이 설정은 PowerShell 스크립트 실행에만 영향을 주며, 일반 프로그램이나 앱 실행에는 전혀 영향이 없습니다.

Q4. Mac이나 Linux에서도 같은 문제가 있나요?

A. 아니요. 이 문제는 Windows PowerShell에만 해당합니다. Mac과 Linux는 이런 제한이 없어요.

마무리

처음엔 어렵게 느껴질 수 있지만, 이 설정은 Python 개발을 위해 필수적인 과정입니다.

한 번만 제대로 설정해두면 앞으로 가상환경을 사용할 때 불편함 없이 개발할 수 있습니다! 🚀

이 글이 도움이 되었다면 댓글로 알려주세요. 혹시 해결이 안 되거나 다른 오류가 발생한다면 댓글에 에러 메시지를 남겨주시면 답변드리겠습니다! 😊

요약 (5초 버전)

# 1. PowerShell을 관리자 권한으로 실행
# 2. 이 명령어 입력:
Set-ExecutionPolicy RemoteSigned
# 3. Y 입력
# 4. VSCode에서 가상환경 활성화
.\.venv\Scripts\Activate.ps1

끝! 🎉

관련 글

Python 가상환경(venv) 완벽 가이드
VSCode Python 개발 환경 세팅하기
pip install 오류 해결 모음

태그: #Python #VSCode #가상환경 #PowerShell #실행정책 #RemoteSigned #초보자 #오류해결 #Windows

728x90