VS Code 파이썬 가상환경 venv 활성화 오류 3분 해결법: ExecutionPolicy 변경 가이드

1. 파이썬 venv 활성화가 차단되는 4가지 기술적 원인

파이썬 설치가 잘 끝났음에도 터미널에서 빨간색 에러 텍스트가 뿜어져 나오는 배경은 윈도우 보안 정책 아키텍처에 있습니다.

  • PowerShell 스크립트 실행 정책(ExecutionPolicy) 제한: 윈도우 클라이언트 OS의 기본 보안 프로필은 Restricted로 설정되어 있어, 외부 서드파티 스크립트 파일(.ps1)의 무단 실행을 원천 차단합니다.
  • 가상환경 활성화 스크립트 형식(.ps1)과의 마찰: venv 폴더 내부의 activate.ps1은 파워셸 전용 스크립트이므로, 시스템 권한 승인이 없으면 OS가 보안 위협으로 간주하여 실행 핸들을 드롭합니다.
  • VS Code 통합 터미널의 기본 프로필 설정: VS Code의 기본 내장 셸이 CMD(명령 프롬프트)가 아닌 PowerShell로 기본 바인딩되어 있어 윈도우의 엄격한 실행 정책을 그대로 상속받는 상태입니다.
  • 인터프리터(Select Interpreter) 미동기화: 가상환경 디렉터리는 생성되었으나 VS Code 워크스페이스가 로컬 시스템 전역 파이썬 경로를 계속 바라보며 환경 변수 패스가 꼬인 경우입니다.

2. VS Code 파이썬 가상환경 활성화 3단계 복구 가이드

보안성을 유지하면서 가장 안전하게 권한을 푸는 정석 방법부터 터미널 우회 방법 순으로 점검합니다.

단계 1: PowerShell 실행 정책을 ‘RemoteSigned’로 변경 (가장 확실한 정석)

로컬에서 직접 생성한 스크립트는 허용하고 인터넷에서 다운로드한 스크립트만 검증하도록 보안 정책을 합리적으로 조정합니다.

  1. 키보드의 Windows 키를 누르고 PowerShell을 검색합니다.
  2. 마우스 우클릭 후 [관리자 권한으로 실행]을 클릭합니다.
  3. 현재 설정된 실행 정책을 확인하기 위해 아래 명령어를 입력하고 엔터를 누릅니다:

Get-ExecutionPolicy

(화면에 Restricted라고 출력된다면 모든 스크립트가 차단되어 있는 상태입니다.)

  1. 현재 로그인된 사용자 계정에 한해 스크립트 실행을 허용하는 안전한 명령어를 입력합니다:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

*”실행 규칙을 변경하시겠습니까?”*라는 안내가 나오면 Y를 입력하고 엔터를 칩니다.

VS Code로 돌아와 터미널을 닫았다가 새로 연 뒤(`Ctrl + Shift + “), 다시 가상환경 활성화를 시도합니다:

.\venv\Scripts\activate

(프롬프트 맨 앞에 (venv) 표시가 뜨면 완벽하게 성공한 것입니다.)

단계 2: VS Code 기본 터미널을 ‘Command Prompt(CMD)’로 전환 (권한 수정 없는 10초 해결)

시스템 보안 정책을 건드리지 않고, 스크립트 제한이 없는 명령 프롬프트(CMD)를 기본 터미널로 지정하여 우회합니다.

  1. VS Code 화면 우측 하단의 터미널 창 우측 상단을 봅니다.
  2. + (새 터미널 추가) 버튼 옆의 작은 아래 화살표(∨)를 클릭합니다.
  3. 드롭다운 메뉴에서 [Select Default Profile (기본 프로필 선택)]을 클릭합니다.
  4. VS Code 상단 검색창에 뜨는 목록 중 Command Prompt (명령 프롬프트)를 선택합니다.
  5. 열려 있던 기존 터미널의 휴지통 아이콘을 눌러 닫고, 단축키 `Ctrl + “(백틱)을 눌러 새 터미널을 엽니다.
  6. 아래의 CMD 전용 명령어를 입력하면 에러 없이 즉시 활성화됩니다:

venv\Scripts\activate.bat

단계 3: VS Code 파이썬 인터프리터 경로 수동 지정

터미널에서 가상환경이 켜졌음에도 에디터 상단에서 모듈 인식(No module named...)이 안 될 때 가상환경 바이너리를 강제로 연결합니다.

  1. VS Code 창에서 단축키 Ctrl + Shift + P를 눌러 명령 팔레트(Command Palette)를 호출합니다.
  2. 입력창에 아래 키워드를 입력하고 선택합니다:

Python: Select Interpreter

  1. 추천 목록 중에서 경로에 ('venv': venv) 또는 .\venv\Scripts\python.exe가 포함된 항목을 클릭합니다.
  2. 만약 목록에 보이지 않는다면 [Enter interpreter path…]를 클릭한 뒤, 현재 프로젝트 폴더 내 venv > Scripts > python.exe 파일을 직접 선택합니다.

3. 해결 방식별 장단점 및 권장 환경 비교표

해결 방식작업 위치적용 난이도보안성 영향영구 해결 여부추천 대상
1단계: RemoteSigned 정책 변경윈도우 PowerShell쉬움 (명령어 1줄)안전 (로컬 검증)영구 해결 (권장)파워셸 환경을 선호하는 표준 개발 환경
2단계: 기본 셸 CMD 변경VS Code 내부 설정매우 쉬움 (클릭 3번)영향 없음영구 해결시스템 정책 수정 권한이 없는 회사 PC
3단계: 인터프리터 경로 지정VS Code 명령 팔레트보통영향 없음프로젝트별 적용(venv)는 떴는데 패키지 임포트가 안 될 때

함께 읽어두면 좋은 개발 환경 & 윈도우 트러블슈팅 가이드:

크롬에서 개발 문서를 보거나 유튜브 코딩 강의를 시청할 때 영상이 깜빡거린다면원격 데스크톱 연결 안됨 내부 오류가 발생했습니다 3분 해결법을 적용해 보세요. 코드 작업 중 한글과 영어 타이핑이 꼬여 먹통이 될 때는USB 디스크가 쓰기 금지되어 있습니다 오류 3분 해결법: 데이터 보존 복구 4단계포스팅을 권장합니다.

마이크로소프트의 공식 기술 문서는Microsoft Learn PowerShell 실행 정책(Execution Policies) 공식 설명서를 참조하시기 바랍니다.

4. 자주 묻는 질문 (FAQ)

Q1. Set-ExecutionPolicy Unrestricted로 설정하면 안 되나요?

Unrestricted(제한 없음)로 설정하면 인터넷에서 다운로드한 출처 불명의 악성 스크립트까지 경고 없이 실행될 위험이 있습니다. 개발 환경에서는 로컬에서 생성된 스크립트만 신뢰하는 RemoteSigned나, 현재 사용자 계정에만 범위를 한정하는 -Scope CurrentUser 옵션을 부여하는 것이 가장 안전한 보안 표준입니다.

Q2. .\venv\Scripts\activate를 쳤는데 “지정된 경로를 찾을 수 없습니다”라고 뜹니다.

현재 터미널의 작업 디렉터리(경로)가 프로젝트 루트 폴더가 아니거나, 가상환경 이름이 venv가 아닌 다른 이름(예: env, myenv)으로 생성되었기 때문입니다. 터미널에서 ls 또는 dir을 입력해 현재 폴더에 venv 디렉터리가 실제로 존재하는지 먼저 확인해 보시기 바랍니다.

Q3. 가상환경을 껐다가 다시 기본 파이썬으로 나가려면 어떻게 하나요?

가상환경을 비활성화하고 전역 시스템 환경으로 빠져나오려면 터미널 프롬프트에 아무 옵션 없이 아래 단어 하나만 입력하고 엔터를 누르면 즉시 (venv) 표시가 사라집니다:

deactivate

Leave a Comment