VSCode에서 파이썬 설치 및 설정 방법

파이썬 개발 환경을 쉽게 구성할 수 있는 VSCode는 개발자에게 인기가 많습니다. VSCode에서 파이썬을 설치하고 설정하는 과정은 다소 복잡해 보일 수 있습니다. 하지만, 아래 내용을 참고해서 단계별로 쉽게 따라하면 됩니다.

이 포스팅에서는 VSCode 파이썬 설치와 플러그인 설정, 코드 실행 방법 등을 알아보았습니다.

Table of Contents

VSCode 설치 방법

VSCode는 다양한 운영 체제에서 사용 가능한 코드 편집기로 설치 과정은 매우 간단합니다.

먼저 Visual Studio Code 공식 웹사이트에 방문합니다. 페이지가 로드되면, 화면 상단에 “Download” 버튼을 찾아 클릭합니다.

다음 운영 체제에 맞는 설치 파일을 선택합니다. 현재 사용하는 운영 체제가 Windows, macOS, 또는 Linux중 하나일 것입니다. 각 운영 체제에 맞는 설치 파일을 다운로드 합니다.

또는 메인 페이지에 있는 Download 버튼을 클릭합니다. 운영 체제에 맞는 프로그램이 자동으로 다운로드 됩니다.

다운로드가 완료되면, 다운로드한 파일을 실행하여 설치 과정을 진행합니다. 설치 마법사가 나타나며 여러 단계가 제시됩니다. 처음이라면 기본 설정으로 사용해도 좋습니다. 또는 바탕 화면에 바로 가기 아이콘 생성이나, 새로운 파일 형식과 자동으로 연동 등의 추가 옵션을 선택합니다.

설치가 완료되면 VSCode를 실행합니다. 처음 실행 시 VSCode를 기본으로 설정할지 혹은 개인 설정을 진행하고 싶은지 묻습니다. 처음 사용 시에는 기본 설정을 추천합니다. 추가 설정은 나중에도 가능합니다.

파이썬 확장 프로그램 설치

파이썬 언어를 VSCode에서 원활하게 사용하려면 파이썬 확장 프로그램을 설치해야 합니다. 확장 프로그램은 코드 자동 완성, 정적 분석, 디버깅, 테스트 실행 등의 다양한 기능을 제공합니다. 파이썬 확장 프로그램을 설치하는 방법을 알아보겠습니다.

먼저 VSCode를 열고 왼쪽 사이드바에 있는 ‘확장’ 아이콘을 클릭합니다. 사이드바에 네모가 여러 개 있는 모양 아이콘이 ‘확장’ 아이콘입니다. ‘Marketplace’ 검색창에 ‘Python’을 입력하고 검색 결과에 나타나는 ‘Python’ 확장 프로그램을 찾습니다.보통 Microsoft에서 제작한 확장 프로그램을 가장 많이 사용합니다.

찾은 후에는 ‘설치’ 버튼을 클릭하여 확장 프로그램을 설치합니다. 설치가 완료되면 VSCode는 자동으로 확장 프로그램을 활성화합니다. 필요에 따라 추가적인 설정을 통해 사용성을 더욱 향상시킬 수 있습니다.

파이썬 실행 환경 설정

파이썬은 다양한 환경에서 사용할 수 있어, 코딩 프로젝트에 알맞게 설정하는 것이 중요합니다. VSCode에서 파이썬 실행 환경을 설정하려면 먼저 Python 인터프리터를 선택해야 합니다. 기본적으로, VSCode는 설치된 Python 인터프리터를 자동으로 감지하지만, 필요에 따라 가상 환경(virtual environment)을 만들어 사용해도 됩니다.

가상 환경을 만들기 위해 터미널에서 다음 명령어를 입력합니다.

python -m venv .env

위 명령어를 실행하면 현재 디렉토리에 `.env`라는 가상 환경 폴더가 생성됩니다. 이제 이 환경을 활성화해야 합니다. 운영 체제에 따라 명령어가 다르니 유의하세요.

Windows의 경우:

.env\Scripts\activate

macOS 및 Linux의 경우:

source .env/bin/activate

환경이 활성화 됐다면 VSCode에서 인터프리터를 선택합니다. `Ctrl + Shift + P`를 눌러 명령 팔레트를 열고 “Python: 셀렉터 인터프리터”를 검색하여 실행하세요. 다음으로 생성한 가상 환경 인터프리터를 선택합니다.

이제 파이썬 실행 환경이 설정됐습니다. 이렇게 하면 프로젝트가 다른 파이썬 환경의 영향을 받지 않고 독립적으로 실행됩니다.

기본 프로그램 실행 방법

VSCode에서 파이썬 개발 환경을 설정한 후, 가장 기본은 프로그램 실행입니다.

1) 코드 파일 실행

코드를 실행하기 위해서는 먼저 .py 확장자를 가진 파이썬 파일을 하나 생성해야 합니다. 예를 들어, `hello_world.py`라는 파일을 만들고 다음과 같은 간단한 파이썬 코드를 입력합니다.

print("Hello, World!")

이제 이 파일을 저장하고, 터미널 창에서 실행 명령어를 사용할 수 있습니다. 터미널은 화면 하단이나 왼쪽의 탐색 메뉴에서 열 수 있습니다. 터미널이 열린 후, 아래와 같이 명령어를 입력해 코드를 실행합니다.

python hello_world.py

코드가 올바르게 입력했다면, 터미널에 “Hello, World!”가 출력됩니다. 이것이 기본적인 파이썬 프로그램 실행 방법입니다.

2)Run 버튼 사용

VSCode 파일 상단에 있는 ‘Run’ 버튼을 사용하여 코드를 실행할 수 있습니다. 이 버튼을 클릭하면 선택한 파일이 즉시 실행되어, 결과를 터미널에서 확인할 수 있습니다.

3) 선택 코드 실행

파이썬 편집기에서 코드를 선택해 터미널에서 실행하는 방법도 있습니다. 실행하고 싶은 코드를 선택하고 Ctrl + Enter를 입력하면, 아래 터미널창이 생성되며 코드가 실행됩니다. 터미널이 열려 있다면, 열린 창에서 실행됩니다. Ctrl + Enter가 동작하지 않으면, 단축키를 살펴보세요.

VSCode의 Preferences로 가면 Keyboard Shortcuts 메뉴가 있습니다. 여기서 python을 검색하면, ‘Run Selection/Line in Python Terminal’ Command가 있습니다. 이 단축키를 변경하면 됩니다.

디버깅 팁

디버깅은 프로그램에서 오류를 발견하고 수정하는 중요한 과정입니다. VSCode에서 효과적으로 파이썬 코드를 디버깅하는 몇 가지 팁을 제공합니다.

첫 번째 팁은 브레이크포인트입니다. 브레이크포인트는 코드 실행을 특정 지점에서 잠시 멈추게 하여 프로그램 상태를 검사할 수 있게 해줍니다. 이를 통해 변수의 값이 어떻게 변하는지, 특정 지점에서의 논리 흐름이 어떻게 진행되는지를 명확히 파악할 수 있습니다. 다음은 브레이크포인트를 설정하는 예제 코드입니다.

def example_function(a, b):
    result = a + b
    return result

x = 5
y = 10

# 다음 줄에 브레이크포인트 설정
sum = example_function(x, y)
print("Sum:", sum)

브레이크포인트를 설정한 후에는 디버그 모드에서 코드를 실행하여 프로그램이 특정 지점에서 멈출 때의 값을 관찰할 수 있습니다.

두 번째 팁은 “Watch” 기능을 활용하는 것입니다. 이 기능은 코드 실행 중 관심 있는 변수의 값을 실시간으로 관찰할 수 있게 해줍니다. 이를 통해 변수의 값이 예상치 못하게 변경되는 지점을 쉽게 탐지할 수 있습니다.

마지막으로, “디버깅 콘솔”을 사용해 직접 커맨드를 입력하고 변수 값을 확인하면 편리합니다. 이는 디버그 세션 중에 즉각적으로 변수에 접근하거나 함수를 실행해보고 싶을 때 효과적입니다. 이러한 도구들을 함께 활용하면 효율적으로 버그를 찾고 해결할 수 있습니다.

VSCode에서 파이썬을 설치하고 설정하는 과정은 간단하지만, 처음 접하는 분들에게는 다소 생소할 수 있습니다. 위의 내용을 따라 한 걸음 한 걸음 나아가다 보면, 매끄럽고 효율적인 개발 환경을 구축할 수 있습니다. 처음 시작하는 분들에게 도움이 됐기를 바랍니다.