웹사이트 검색

Visual Studio Code 터미널에서 Python이 작동하지 않음

Visual Studio Code 터미널에서 Python 코드를 실행하려고 할 때, 'python을 인식할 수 없습니다'와 같은 오류가 발생하거나 스크립트 실행에 실패할 수 있습니다. 이는 일반적으로 VS Code가 Python 설치 또는 환경을 찾거나 올바르게 사용하지 못하고 있음을 나타냅니다. 이 가이드에서는 Visual Studio Code 터미널에서 Python이 작동하지 않을 때 어떻게 할 수 있는지 알아보겠습니다.

Visual Studio Code 터미널에서 Python이 작동하지 않음

Python은 여러 가지 이유로 VS Code 터미널에서 작동하지 않을 수 있습니다. 시스템의 PATH 환경 변수에 Python 실행 파일 경로가 없거나, VS Code에서 잘못된 Python 인터프리터가 선택되어 있거나, 가상 환경이 활성화되지 않았거나, 터미널 셀 자체가 잘못 구성되었을 수 있습니다. 또한, 여러 Python 설치가 충돌을 일으킬 수 있으며, 때때로 환경 설정을 새로 고치기 위해 VS Code나 터미널을 간단히 재시작해야 할 때도 있습니다.

Visual Studio Code 터미널에서 Python이 작동하지 않는다면, 아래 해결 방법을 따르세요.

  1. 시스템 PATH에 Python을 추가하세요
  2. VS Code에서 올바른 Python 인터프리터를 선택하세요
  3. 가상 환경을 수동으로 활성화하세요
  4. VS Code와 터미널을 다시 시작하세요

그들에 대해 자세히 이야기해 봅시다.

1. Python을 시스템 PATH에 추가하세요

터미널에서 python을 입력했을 때 Python이 인식되지 않는다면, 이는 터미널이 Python 실행 파일을 찾을 수 없다는 것을 의미합니다. Python을 PATH 환경 변수에 추가하면 운영 체제에 Python을 어디서 찾아야 하는지 알려주어 어떤 디렉토리에서도 실행할 수 있게 됩니다. 아래 단계를 따라 문제를 해결하세요.

  • Python 설치 폴더를 찾으세요(예: C:\Python39 또는 C:\Users\<username>\AppData\Local\Programs\Python\Python39).
  • 또한 그 안에 있는 Scripts 하위 폴더를 찾으세요(예: C:\Python39\Scripts).
  • 열기 시스템 속성 > 고급 > 환경 변수.
  • 시스템 변수에서 Path를 선택하고 편집을 클릭합니다.
  • Python 설치 폴더와 Scripts 폴더를 모두 새 항목으로 추가하세요.
  • 확인을 클릭하고, 모든 대화 상자를 닫은 다음, VS Code를 재시작하세요.

이제 문제가 해결되었는지 확인하세요.

2. VS Code에서 올바른 Python 인터프리터 선택

VS Code는 선택한 Python 인터프리터를 사용하여 코드를 실행하고 디버그합니다. 인터프리터가 존재하지 않거나 잘못 구성된 Python 버전으로 설정되어 있으면 터미널의 명령이 실패할 수 있습니다. 올바른 것을 명시적으로 선택하면 VS Code가 올바른 Python 환경을 사용하도록 보장할 수 있습니다.

아래 단계를 따르세요.

  1. VS Code를 엽니다.
  2. 이제 Ctrl + Shift + P를 눌러 명령 팔레트를 엽니다.
  3. 타입 Python: Select Interpreter를 입력하고 선택하세요.
  4. 사용 가능한 Python 설치 목록이 나타납니다. 사용하려는 것을 선택하세요(예: 시스템 Python 또는 가상 환경).
  5. 선택 후, 새로운 터미널 (Ctrl+`)을 열면 VS Code가 해당 환경을 터미널에서 자동으로 활성화합니다.

이제 문제가 지속되는지 확인하세요.

3. 가상 환경을 수동으로 활성화하세요

가상 환경을 사용 중인데 활성화되지 않은 경우, 터미널은 기본적으로 전역 Python 인터프리터를 사용합니다. 이는 패키지 누락 오류를 일으키거나, 환경의 Python이 PATH에 없으면 명령을 찾을 수 없음 오류를 일으킬 수 있습니다. 환경을 활성화하면 해당 세션에 대해 올바른 경로가 설정됩니다.

VS Code 터미널을 열고, 프로젝트 폴더로 이동한 다음, 다음 명령어를 실행하여 환경을 활성화해야 합니다.

윈도우 명령 프롬프트

venv\Scripts\activate

윈도우 파워셸

.\venv\Scripts\Activate.ps1

실행 정책이 이를 차단하면 먼저 Set-ExecutionPolicy Unrestricted -Scope Process를 실행하세요.

터미널 프롬프트에서 환경 이름을 확인할 수 있습니다. 이제 Python 명령어는 가상 환경을 사용합니다.

4. VS 코드와 터미널을 재시작합니다

때때로, 환경 변수나 VS Code의 내부 상태가 오래되어 문제가 발생할 수 있습니다. VS Code를 완전히 다시 시작하면 캐시된 설정이 지워지고 터미널이 새로운 환경 변수로 다시 로드되어 일시적인 문제를 해결할 수 있습니다.

모든 작업을 저장하고, 이제 VS Code를 완전히 종료하세요. 이렇게 하려면 작업 관리자를 열고, Visual Studio Code를 마우스 오른쪽 버튼으로 클릭한 다음 작업 끝내기를 선택하세요. VS Code와 프로젝트를 다시 열고, 새 터미널(Ctrl + `)을 열어 Python을 다시 실행해 보세요.

문제가 계속되면, 명령 팔레트에서 개발자: 창 다시 로드 명령도 사용해 보세요.

희망적으로, 이 해결책들이 당신에게 효과가 있기를 바랍니다.

VS Code 터미널에서 Python을 활성화하는 방법은?

VS Code 터미널에서 Python을 사용하려면 먼저 시스템에 Python이 설치되어 있고 PATH 환경 변수에 추가되어 있는지 확인하세요. 그 다음, VS Code를 열고 Ctrl+Shift+P를 눌러 명령 팔레트를 엽니다. 거기서 Python: Select Interpreter 명령을 실행하여 적절한 Python 설치를 선택합니다. 인터프리터를 선택한 후, Ctrl+` (백틱 키)를 눌러 새 터미널을 엽니다. VS Code는 선택된 Python 환경을 자동으로 활성화하여 Python 명령을 직접 실행할 수 있게 합니다. 터미널이 여전히 Python을 인식하지 못하면, VS Code를 다시 시작하거나 이전 가이드에 설명된 대로 시스템 PATH에 Python을 수동으로 추가해 보세요.

VS Code 터미널이 작동하지 않을 때 해결하는 방법은?

VS Code 터미널이 열리지 않거나 명령 실행에 실패하는 등 작동하지 않는 경우, 먼저 VS Code와 컴퓨터를 모두 재시작하세요. 그런 다음, 명령 팔레트를 통해 기본 터미널 프로필을 확인하고 PowerShell, 명령 프롬프트(Command Prompt), 또는 bash와 같은 안정적인 셸로 설정하세요. 문제가 계속되면, 설정에서 terminal.integrated를 검색하여 변경 사항을 되돌려 VS Code 설정을 재설정하세요. 또한 Developer: Reload Window 명령을 실행할 수 있습니다. 마지막으로, 충돌을 일으킬 수 있는 최근 설치된 확장 기능을 비활성화하고 셸 실행을 방해할 수 있는 환경 변수를 확인하세요.

관련기사