Visual Studio Code에서 파이썬 실행하기: 단계별 가이드

VS Code에서 Python 개발 환경 설정부터 코드 실행까지! 초보자를 위한 단계별 가이드를 통해 Python 설치, 환경 변수 설정, 확장 프로그램 설치, 파일 생성 및 실행 방법을 쉽게 알아보세요. 시작부터 완성까지 친절하게 알려드립니다

VS Code에서 Python 시작하기

Python을 처음 시작할 때 가장 큰 걸림돌 중 하나가 바로 개발 환경 설정입니다. 특히, 코드를 작성하고 테스트할 때 사용하는 개발 환경이 편리하면 Python 학습 속도가 훨씬 빨라지는데요. Visual Studio Code(이하 VS Code)는 Python 초보자도 간편하게 사용할 수 있는 코드 편집기로, 설치가 간단하고 필요한 확장을 추가하기 쉬워 많은 개발자에게 인기입니다.

이 가이드에서는 VS Code를 사용하여 Python을 설치하고 실행하는 방법을 단계별로 설명드리겠습니다. 설치부터 환경 설정, 오류 해결 방법까지 꼼꼼하게 다뤄보며, Python 실행이 처음이신 분들도 쉽게 따라 하실 수 있도록 작성했습니다.

1. Visual Studio Code 설치 및 준비

VS Code 다운로드 및 설치

1. VS Code 공식 웹사이트에 접속해 주세요.
2. 페이지 상단의 “Download” 버튼을 클릭하여 사용하는 운영체제에 맞는 버전을 선택합니다. VS Code는 Windows, macOS, Linux 모두 지원됩니다.
3. 다운로드가 완료되면 설치 파일을 실행하고 안내에 따라 설치를 진행합니다. 설치 시 특별히 설정을 변경하지 않아도 기본 옵션으로 충분히 사용할 수 있습니다.

설치가 완료되면 바탕 화면이나 프로그램 목록에서 “Visual Studio Code”를 찾아 실행해 주세요. 이제 Python 환경을 설정할 준비가 끝났습니다.

2. Python 설치 및 환경 변수 설정

Python을 실행하려면 먼저 Python을 설치하고, 터미널에서 Python을 인식할 수 있도록 PATH 설정이 필요합니다. 설치 중 이 부분을 놓치면 나중에 Python이 제대로 작동하지 않을 수 있습니다.

Python 다운로드 및 설치

1. Python 공식 웹사이트에 접속해 주세요.
2. 상단 메뉴에서 “Downloads”를 선택하고, 사용하는 운영체제에 맞는 버전을 다운로드합니다.
3. 설치 파일을 실행하고 설치 옵션에서 “Add Python to PATH”를 반드시 체크한 후, “Install Now”를 클릭하여 설치를 완료합니다.

설치 확인 및 PATH 설정 확인

1. VS Code의 Terminal > New Terminal을 열어 터미널 창을 엽니다.
2. 터미널에 python --version을 입력하고 Enter를 누릅니다.
3. Python 버전이 출력되면 정상적으로 설치된 것입니다. 예를 들어, Python 3.9.7과 같은 형태로 표시될 것입니다.

만약 “python 명령어를 찾을 수 없습니다”와 같은 오류가 뜨면, Python이 PATH에 추가되지 않았을 가능성이 큽니다. 이 경우 Python을 다시 설치할 때 “Add Python to PATH” 옵션을 체크해 주세요.

3. Visual Studio Code에 Python 확장 설치

VS Code는 다양한 프로그래밍 언어를 지원하며, Python을 더 편리하게 사용하기 위해 Microsoft에서 제공하는 Python 확장을 설치하는 것이 좋습니다.

Python 확장 프로그램 설치

1. VS Code 왼쪽 사이드바에서 확장(Extensions) 아이콘을 클릭해 확장 메뉴로 이동합니다.
2. 검색창에 “Python”을 입력하고, Microsoft에서 제공하는 Python 확장을 설치해 주세요.

Python 확장을 설치하면 Python 코드 자동 완성, 디버깅, 코드 실행 등 다양한 기능을 활용할 수 있습니다.

기본 환경 설정

1. VS Code 상단 메뉴에서 File > Preferences > Settings로 이동합니다.
2. 검색창에 “Python Path”를 입력하고, 자동으로 설정된 Python 경로가 맞는지 확인합니다.

4. 파이썬 파일 생성 및 실행

이제 직접 파이썬 파일을 만들어 코드를 실행해 보겠습니다.

새로운 파이썬 파일 생성

1. VS Code에서 File > New File을 선택해 새 파일을 엽니다.
2. 상단 메뉴에서 File > Save As를 클릭해 파일 이름을 정합니다. 파일 확장자는 .py로 지정해야 합니다. 예를 들어, hello.py로 저장합니다.
3. 새 파일에 다음 코드를 입력해 보세요. print("Hello, Python!")

Python 코드 실행

VS Code에서 Python 코드를 실행하는 방법은 크게 세 가지입니다.

1. 터미널에서 실행하기
   상단 메뉴에서 Terminal > New Terminal을 클릭해 터미널을 엽니다. python 파일이름.py 명령어로 실행합니다. 예를 들어, python hello.py를 입력하면 터미널 창에 “Hello, Python!”이 출력됩니다.
2. 단축키 사용
   코드를 작성한 상태에서 F5 키를 누르면 Python 코드가 바로 실행됩니다. 실행 결과는 VS Code의 하단 터미널 창에 표시됩니다.
3. GUI 메뉴 사용
   작성한 파일을 오른쪽 클릭하여 Run Python File in Terminal 옵션을 선택합니다. 이 방법은 명령어 입력이 익숙하지 않은 초보자에게 특히 유용합니다.

5. 오류 해결 및 유용한 팁

자주 발생하는 오류와 해결 방법

1. Python이 인식되지 않는 경우
   Python 설치 중에 PATH 추가를 잊은 경우 발생할 수 있습니다. Python을 다시 설치할 때 “Add Python to PATH” 옵션을 선택해 주세요.
2. Python 확장 프로그램 오류
   Python 확장이 설치되었음에도 코드 실행이 원활하지 않다면, 확장 프로그램을 제거 후 다시 설치해 보세요.
3. 터미널에서 Python 명령어 오류
   Windows에서는 python 대신 py 명령어가 작동하는 경우가 있습니다. py 파일이름.py 형식으로 실행해 보세요.

추가 팁

1. Python 인터프리터 설정
   VS Code 하단의 Python Version 부분을 클릭해 원하는 Python 버전을 설정할 수 있습니다. 여러 버전을 사용할 때 특히 유용합니다.
2. 가상 환경 설정
   Python 프로젝트마다 독립된 환경을 사용해야 할 때가 있습니다. python -m venv 가상환경이름 명령으로 가상 환경을 생성한 후, source 가상환경이름/bin/activate로 활성화할 수 있습니다.

결론

지금까지 VS Code에서 Python을 설치하고 실행하는 방법을 단계별로 알아보았습니다. VS Code와 Python을 사용하면 코드 작성, 디버깅, 실행이 한 환경에서 가능하여 개발 효율이 높아집니다.

Python 초보자라면 코드 실행과 환경 설정에 익숙해진 후, 다음 단계로는 Python 디버깅과 가상 환경 관리 등을 배우는 것이 좋습니다. Visual Studio Code 공식 문서에서 더 많은 기능을 확인해 보세요.

이제 Python 코드를 작성하고 실행해 보면서 다양한 실습을 통해 경험을 쌓아보세요!