Python 개발을 위해 Visual Studio Code를 구성하는 방법



Python은 데이터 분석, AI, 웹 앱 등 거의 모든 곳에 사용됩니다. Windows에서 Python 개발을 시작한다면 Visual Studio Code(VS Code)를 사용하는 것이 확실한 선택입니다.가볍고 매우 유연하며 확장 기능이 매우 많습니다.하지만 제대로 설정하는 것은, 특히 Python을 처음 접하는 사람에게는 다소 어려울 수 있습니다.때로는 예상대로 작동하지 않을 수 있습니다. Python이 실행되지 않거나 VS Code가 인터프리터를 인식하지 못할 수도 있습니다.어떤 설정에서는 작동하지만 다른 설정에서는 작동하지 않는 이유는 확실하지 않지만, 적절한 설치 및 구성이 중요합니다.따라서 Python과 VS Code 설치부터 모든 것을 구성하는 것까지, 필수 사항을 다루는 간단한 연습 과정을 통해 좌절 없이 코딩을 시작할 수 있도록 도와드리겠습니다.

Windows에서 Python 설정을 수정하고 VS Code를 사용할 수 있도록 하는 방법

Python 인터프리터가 제대로 작동하도록 하기

첫째, Python을 올바르게 설치하고 어디에서나 액세스할 수 있어야 합니다.그렇지 않으면 VS Code가 혼란스러워질 것입니다.일반적으로 Python을 PATH 환경 변수에 추가하기만 하면 되지만, 설치 프로그램이 자동으로 추가하지 않아서 막히는 경우가 있습니다.터미널에 “Python을 인식할 수 없습니다”라는 메시지가 표시되면 대개 단서입니다.이 문제를 해결하려면 PATH를 확인하거나 올바른 옵션으로 Python을 다시 설치해야 합니다. Windows에서 가장 쉬운 방법은 설치 프로그램을 실행하고 PATH에 Python 추가 라는 상자를 선택 하고 모든 사용자용으로 설치를 선택했는지 확인하는 것입니다.그런 다음 명령 프롬프트나 PowerShell 창을 열고 다음을 입력합니다.

python --version

설치된 Python 버전이 표시되면 문제가 없는 것입니다.그렇지 않은 경우 다음을 편집하여 수동으로 추가해야 할 수 있습니다.

C:\Users\YourName\AppData\Local\Programs\Python\Python310\

Python이 설치된 위치를 시스템 환경 변수 Path 에 추가하면 됩니다.약간 번거롭지만, 한 번 설정해 놓으면 VS Code가 마법처럼 Python을 자동으로 감지해 줍니다.

Visual Studio Code 설치 및 구성

다음으로, VS Code를 해당 사이트 에서 다운로드하세요.설치 프로그램을 실행하고 라이선스에 동의한 후 설치 위치를 선택하고, 가장 중요한 것은 ” PATH에 추가 ” 확인란을 선택하는 것입니다. Windows는 불필요하게 복잡한 환경을 만들기를 좋아하기 때문입니다.또한, 빠른 바로가기를 원한다면 “바탕 화면 아이콘 만들기”를 활성화하세요.설치를 완료한 후 VS Code를 엽니다.이제 거의 사용할 수 있지만, Python을 제대로 사용하려면 Python 확장 프로그램을 설치해야 합니다.

VS Code에 Python 확장 기능 추가

VS Code에서 확장 프로그램 아이콘을 클릭하거나 를 누르고 PythonCtrl + Shift + X 을 검색하세요. Microsoft 공식 Python이 필요합니다.설치를 클릭하세요.이 확장 프로그램은 활성화 속도가 느리거나, 활성화 후 VS Code를 다시 시작해야 할 수 있습니다.문제가 발생하더라도 걱정하지 마세요.재시작하거나 창을 다시 로드해야 할 수도 있습니다( 그런 경우 창 다시 로드를 선택하세요).Ctrl + Shift + P

VS Code에서 Python이 인식되는지 확인하세요

설치가 완료되면 프로젝트 폴더를 열거나 새 폴더를 만드세요.왼쪽 하단에 Python 인터프리터가 보일 것입니다.보이지 않으면 를 누르고 Ctrl + Shift + P“Python: Select Interpreter”를 입력하세요.방금 설치한 Python 버전을 선택하세요.만약 없다면 PATH를 다시 ​​확인하거나 VS Code를 재시작해 보세요.일부 컴퓨터에서는 Python이 처음 시도했을 때는 나타나지 않다가 재시작하면 마법처럼 나타나기도 합니다.이상하게 들리겠지만, Windows에서는 이런 일이 흔합니다.

Python 코드 작성 및 실행 – 어렵지 않아요

이제 프로젝트 폴더 안에 새 파일( .py )을 만들고, 다음과 같은 간단한 코드를 작성하세요.

# Hello World print("Hello, world!") 

파일을 저장한 후 실행 버튼을 누르거나 Ctrl + F5를 사용하여 실행하세요.모든 것이 제대로 구성되었다면 내장 터미널에 출력이 표시됩니다.그렇지 않은 경우 인터프리터 설정을 다시 확인하세요. VS Code가 어떤 Python을 사용해야 할지 몰라 코드를 실행하지 못하는 경우가 있습니다.인터프리터를 다시 선택하고 다시 시도해 보세요.일반적으로 재시작이나 재구성으로 해결할 수 있습니다.

확장 기능을 사용하여 더 나은 환경 만들기

좋습니다.일단 실행을 시작하면 생산성을 크게 높여줄 몇 가지 확장 프로그램을 설치하는 것을 고려해 보세요.

  • Pylance : 빠르고 정확한 자동완성 및 입력 지원의 스타.
  • Jupyter : 노트북을 좋아한다면 데이터 과학 작업이 훨씬 수월해집니다.
  • autoDocstring : 자동으로 docstring을 생성하여 입력하는 수고를 크게 줄여줍니다.
  • Python 테스트 탐색기 : VS Code를 벗어나지 않고도 테스트를 실행할 수 있습니다.

거의 다 됐네요.이것들을 설정하면 Python 개발이 훨씬 더 수월해집니다.다만, PATH가 제대로 설정되지 않았거나 확장 프로그램이 즉시 로드되지 않으면 Windows에서 가끔 오류가 발생한다는 점을 기억하세요.인터프리터를 재시작하거나 다시 선택하면 이상한 버그가 해결되는 경우가 많습니다.

요약

  • Python이 “PATH에 추가”가 체크된 상태로 설치되었는지 확인하세요.
  • VS Code를 설치하고 설정 중에 “PATH에 추가”를 체크하세요.
  • VS Code 내에 Python 확장 프로그램을 설치하세요
  • “Python: 인터프리터 선택”을 통해 올바른 인터프리터를 선택하세요.
  • Python 파일을 만들고 실행하세요

마무리

Python과 VS Code를 원활하게 작동하게 하려면 약간의 시행착오가 필요할 수 있습니다.특히 Windows의 특성상 더욱 그렇습니다.하지만 일단 설정만 잘 되면 코드 작성과 실행이 훨씬 수월해집니다. Python 버전, 확장 프로그램, 환경이 제대로 구성되었는지 확인하세요.그리고 환경 변수 편집에 익숙하지 않다면 PATH 설정을 건드리지 않는 것이 좋습니다.이 글이 누군가의 골치 아픈 일을 덜어줄 수 있기를 바랍니다.행운을 빌고, 즐거운 코딩 되세요!



이 글이 도움이 되었나요?