VSCODE 파이썬 설치 오류 1분내 해결 방법 (Error while installing ‘Python’ extension 오류)

이번 포스팅에서는 비쥬얼 스튜디오 코드, VSCODE 파이썬 설치 오류 해결 방법에 대해 정리해보려고 합니다.

비쥬얼 스튜디오 코드(VSCODE)는 마이크로소프트에서 개발한 무료 오픈소스 통합 개발 환경(IDE)입니다. VSCODE는 파이썬 코딩 외에도 다양한 목적으로 사용되는데요, 아래와 같은 특징과 장점을 가지고 있습니다.

  1. 다양한 언어(파이썬, 자바, C# 등)를 지원합니다.
  2. 코드 자동완성, 디버깅, Git과의 연동 등 다양한 기능을 제공합니다.
  3. 확장성이 높아, 다양한 플러그인을 설치하여 개발 환경을 구축할 수 있습니다.
  4. 경량화된 환경을 제공하여 빠르고 부하가 적습니다.

VSCODE는 다양한 언어와 프레임워크를 지원하며, 개발 환경의 유연성과 확장성이 높기 때문에 굉장히 사용하기 편리합니다.

특히 파이썬 개발에서는 파이썬 확장팩(Extension Package)을 설치하여 다양한 기능을 지원받을 수 있는데요, 문제는 VSCODE 파이썬 설치 오류가 발생하여 이러한 파이썬 확장팩을 사용하지 못하는 경우가 생긴다는 점 입니다.

이번 포스팅에서는 VSCODE 파이썬 확장팩 설치 오류에 대해 알아보고, VSCODE 파이썬 설치 오류 해결 방법에 대해 알아볼 예정입니다.


VSCODE 파이썬 설치 오류 현상 (확장팩 설치 오류)

앞선 포스팅에서 VSCODE 설치 및 파이썬 설정 방법에 대해 정리한 바 있는데요, 가끔씩 아래와 같이 파이썬 확장팩을 설치하려고 하면 파이썬 설치 오류가 나타나는 경우가 있습니다.

아래와 같이 Extension Market에서 “Python”을 검색해서 “Install”을 하면 되는데요,

VSCODE 파이썬 설치

설치를 진행하고자 하면 아래와 같은 오류가 나타나는 경우가 있으며, 아무리 “Install” 버튼을 눌러도 해결되지 않는 경우가 있습니다.

“Error while installing ‘Python’ extension. Please check the log for more details.”

VSCODE 파이썬 설치 오류

이러한 경우에는 우선 아래와 같은 5가지를 점검해보고, 문제가 없을 경우 다음 세션에서 소개한 방법으로 수동으로 설치하는 것을 추천합니다.

  1. 인터넷 연결 확인
  • Python Extension을 설치하기 위해서는 인터넷 연결이 필요합니다. 인터넷 연결 상태를 확인해봅니다. 의외로 인터넷 연결이 끊겨서 설치가 안되는 경우가 많습니다.
  1. 확장 기능 폴더 권한 확인
  • Python Extension을 설치할 때, 설치 폴더의 권한이 충분하지 않으면 오류가 발생할 수 있습니다. 따라서, 설치 폴더의 권한을 확인하고 적절한 권한을 부여한 후 설치를 시도해 보세요.
  1. Visual Studio Code 버전 업그레이드
  • Visual Studio Code의 버전이 낮은 경우 Python Extension 설치가 제대로 되지 않을 수 있습니다. 따라서, 최신 버전으로 업그레이드한 후 설치를 시도해 보세요.
  1. 기존 확장 기능 제거
  • Python Extension 설치가 제대로 되지 않을 경우, 기존의 Python Extension 확장 기능이 충돌을 일으킬 수 있습니다. 따라서, 기존에 설치된 Python Extension 확장 기능을 모두 제거한 후 다시 설치해 보세요.
  1. 재시작
  • Visual Studio Code를 재시작한 후 Python Extension을 다시 설치해봅니다.

만약 위의 5가지를 점검해서 문제가 없을 경우에는 수동으로 파이썬 확장팩 설치를 진행해야 합니다.


VSCODE 파이썬 설치 오류 해결 방법

VSCODE 파이썬 설치 오류가 여전히 해결되지 않는다면 아래와 같은 방법으로 수동으로 파이썬 확장팩 설치가 가능합니다.

1. Visual Studio Marketplace 접속 및 Python 확장팩 다운로드

여기 링크를 통해 아래와 같은 Visual Studio Marketplace 페이지에 접속한 다음, “python”을 검색합니다.

VSCODE 파이썬 설치 오류 1분내 해결 방법 (Error while installing 'Python' extension 오류)

검색 결과 중에서 가장 처음 나타난 “python” 항목을 선택하여 해당 페이지에서 파일을 다운로드 받습니다. (우측 하단에 “Download Extension” 부분을 누르면 다운로드가 가능합니다.)

VSCODE 파이썬 설치 오류

3. Extensions 우측 끝 … 선택 > “Install from VSIX…” 선택

다시 VSCODE로 돌아온 다음, Extensions 부분 우측 상단에 있는 점 세개를 선택한 다음, 우측에 나타난 “Install from VSIX…”을 선택해줍니다.

VSCODE 파이썬 설치 오류

그 다음 아래와 같이 다운로드 받은 파일을 선택해주면 설치가 되는 것을 확인할 수 있습니다.

VSCODE 파이썬 설치 오류

설치가 완료되면 아래와 같이 “설치됨” 부분에 Python이 나타나는 것을 확인할 수 있습니다. (참고로 만약 여전히 설치가 안된다면 재부팅 후 다시 설치를 진행해봅니다.)

VSCODE 파이썬 설치 오류

이번 포스팅에서는 VSCODE 파이썬 확장팩 설치 오류에 대해 알아보고, VSCODE 파이썬 설치 오류 해결 방법에 대해 알아보았습니다.


앞선 포스팅에서 정리한 프로그래밍/코딩 관련 글은 아래와 같습니다.

선 포스팅에서 정리한 코딩/프로그래밍 관련 글은 아래와 같습니다.

ChatGPT API 사용 방법 3분내 끝내기 (1) Text-Davinci-003 특징 및 OpenAI 계정 생성하기

ChatGPT API 사용 방법 3분내 끝내기 (2) Text-Davinci-003 API Key 생성 및 파라미터 설정 방법

Leave a Comment