파이썬 개발을 위한 VS Code 설치 및 설정 가이드

파이썬 사용을 위한 VS Code(비주얼스튜디오) 설치와 설정 방법

이 블로그 포스트에서는 파이썬 사용을 위한 VS Code(비주얼스튜디오) 설치와 설정 방법을 자세히 설명합니다. 간편하게 따라 할 수 있도록 단계별로 정리하였습니다.

1. 다운로드 및 설치

파이썬 사용을 위한 VS Code(비주얼스튜디오) 설치는 첫 단계로, 매우 직관적이며 간단한 과정입니다. 이 절차를 따라 간편하게 다운로드 받고 설치하는 방법을 알아보겠습니다.

1.1 비주얼스튜디오 코드 다운로드

비주얼스튜디오 코드(Visual Studio Code)는 마이크로소프트가 개발한 무료 소스 코드 에디터입니다. 아래 단계에 따라 다운로드할 수 있습니다.

비주얼스튜디오 코드의 공식 웹사이트인 https://code.visualstudio.com/>Visual Studio Code에 접속합니다.
페이지 중앙에 있는 Download 버튼을 클릭합니다. 두 가지 옵션이 제공됩니다:
Stable: 안정화된 버전으로 버그가 최소화된 상태입니다.
Insiders: 최신 기능을 선탑재한 버전이지만 불안정할 수 있습니다.
운영 체제에 맞는 설치 파일을 선택합니다. Windows, macOS 각각에 맞는 버전이 준비되어 있습니다.

이제 다운로드가 완료되었다면, 설치 과정을 진행하겠습니다.

1.2 VS Code 설치 방법

다운로드한 설치 파일을 실행하여 설치를 진행합니다. 설치 과정은 대체로 자동으로 진행되며, 특별한 옵션이 없으면 기본 설정으로 진행할 수 있습니다. 설치 중 사용자에게 몇 가지 질문이 나올 수 있습니다. 예를 들어, Add to PATH 또는 Open with Code 선택사항이 있습니다. 이 옵션들을 활성화해두면 추후 편리합니다.

설치 항목	설명
Add to PATH	VS Code를 모든 경로에서 사용할 수 있도록 설정
Open with Code	파일 탐색기에서 마우스 우클릭 시 VS Code로 열 수 있도록 설정

설치가 완료되면, VS Code를 열어 초기 화면을 확인합니다.

2. 여러가지 자잘한 설정

설치가 완료된 후, VS Code를 효율적으로 사용하기 위한 여러 가지 설정을 해야 합니다. 이 단계에서는 확장 프로그램 설치, 언어 설정, 가상환경 설정 등을 중심으로 설명하겠습니다.

2.1 확장 프로그램 설치

VS Code의 가장 큰 장점 중 하나는 다양한 확장 프로그램을 통해 기능을 확장할 수 있다는 점입니다. 파이썬을 사용하기 위해 필요한 기본 확장은 Python과 Code Runner입니다.

VS Code를 열고, 왼쪽 사이드바에서 확장 아이콘(네모 안에 네 줄)을 클릭합니다.
검색창에 Python을 입력하여 Microsoft에서 제공하는 Python 확장을 찾습니다. 설치 버튼을 클릭하여 설치합니다.
같은 방법으로 Code Runner 확장도 설치합니다. 이 확장을 이용하면 코드 스니펫을 빠르게 실행할 수 있습니다.

설치 확장개요	설명
Python	파이썬 언어 지원
Code Runner	다양한 언어의 소스 코드를 실행 가능하게 도와줌

2.2 한글 설정

비주얼스튜디오 코드를 한글로 설정하면, 더 쉽게 사용할 수 있습니다. 다음의 과정을 통해 한글 언어팩을 설치할 수 있습니다.

메뉴에서 Extensions 아이콘을 클릭합니다.
검색창에 korean을 입력하고 Korean Language Pack for Visual Studio Code를 찾습니다.
오른쪽 버튼에 있는 Install을 클릭하여 설치합니다.
설치가 완료되면, 오른쪽 하단에 Change Language and Restart?라는 메시지가 나오고, 파란색 버튼을 클릭하여 VS Code를 재시작합니다.

2.3 가상환경 또는 파이썬과 연결하기

파이썬 개발을 진행하기 위해 가상환경을 설정하고 연결하는 것이 좋습니다. 이를 위해 Anaconda나 venv와 같은 도구를 사용할 수 있습니다.

Ctrl+Shift+P를 눌러 명령 팔레트를 엽니다.
Python: Select Interpreter를 선택합니다.
원하는 가상환경을 선택한 후, 그 안의 파이썬 실행 파일을 지정합니다.

이 과정이 완료되면, 이제부터 선택한 가상환경 내에서 파이썬 코드를 실행할 수 있습니다.

2.4 작업폴더 생성

VS Code에서 작업할 폴더를 생성하거나 기존 폴더를 선택하여 개발을 시작할 수 있습니다.

왼쪽 상단의 탐색기 아이콘을 클릭합니다.
파일 > 폴더 열기를 선택합니다.
새 폴더를 만들거나 기존 폴더를 선택하여 폴더 선택 버튼을 클릭합니다.

이제 필요한 파일들을 이 폴더 내에서 관리할 수 있습니다.

2.5 기본 터미널 바꾸기

간혹 VS Code에서 아나콘다 환경이 제대로 작동하지 않을 때가 있습니다. 이럴 때는 기본 터미널을 변경하는 것이 도움이 될 수 있습니다.

Ctrl + Shift + P를 눌러 Command Palette를 엽니다.
Terminal: Select Default Profile을 입력합니다.
드롭다운에서 Command Prompt나 Git Bash를 선택합니다.

터미널 종류	설명
Command Prompt	윈도우 기본 커맨드 프롬프트로 실행
Git Bash	Git Bash를 이용한 셸 환경

2.6 vscode 환경 설정

VS Code의 설정은 사용자의 편의에 맞게 조정할 수 있습니다. 예를 들면, 자동 줄바꿈, 폰트 크기, 자동 저장 등이 있습니다.

자동 줄바꿈: 메뉴에서 보기(View) > 자동줄바꿈(Toggle Word Wrap)을 선택하면 코드가 자동으로 줄바꿈 됩니다.
폰트 크기: File > Preferences > Settings 메뉴에서 Editor: Font Size를 조정하여 사용할 폰트 크기를 설정합니다.
자동 저장: 설정에서 Files: Auto Save로 자동 저장 기능을 설정할 수 있습니다.

설정 항목	설명
자동 줄바꿈	코드가 자동으로 새로운 줄에서 시작하도록 설정
폰트 크기	가독성을 높이기 위해 폰트 크기를 사용자에 맞게 조정
자동 저장 이력	작성한 코드가 자동으로 저장되는 주기를 설정

3. 파이썬 실행 확인

모든 설정이 끝나면, 이제 파이썬이 정상적으로 작동하는지 확인할 차례입니다. 아래의 단계를 따라 파이썬 코드가 잘 실행되는지를 테스트해 보겠습니다.

3.1 가상환경 진입

우선, 작업할 가상환경에 진입해야 합니다. 터미널을 열고 아래 명령어를 입력합니다.

bash
conda activate 가상환경명

3.2 파이썬 코드 실행하기

가상환경에 진입한 후, 기본 파이썬 코드인 Hello World를 실행해 보겠습니다.

python
print(Hello World!!)

이 코드를 입력하고, Ctrl + Alt + N 또는 오른쪽 클릭 후 Run Code를 선택하여 실행할 수 있습니다. 출력 창에서 Hello World!!가 정상적으로 출력되면 모든 설정이 완료된 것입니다!

결론

파이썬 사용을 위한 VS Code(비주얼스튜디오) 설치와 설정 방법을 살펴보았습니다. 필요한 도구의 설치부터 시작해 환경 설정, 코드 실행 확인까지의 과정을 단계별로 설명했습니다. 이러한 과정을 통해 여러분들이 더욱 효율적으로 파이썬을 사용할 수 있기를 바랍니다.

앞으로 코딩 작업을 진행하면서 혹시 문제가 생기거나 궁금한 점이 있다면 이 포스트를 다시 찾아보시길 바랍니다. 자, 이제 여러분도 파이썬 코딩의 세계에 뛰어들 준비가 되셨습니다!

자주 묻는 질문과 답변

질문1: VS Code에서 파이썬 실행이 되지 않아요. 어떻게 해야 하나요?
답변1: VS Code가 가상환경을 올바르게 설정하고 있는지 확인하고, 올바른 파이썬 인터프리터가 선택되어 있는지 확인해 보세요.

질문2: 설치가 제대로 안 되거나 오류가 발생합니다.
답변2: 설치 파일의 무결성을 확인한 후 다시 다운로드하여 설치해 보세요. 클린 설치로 문제를 해결할 수 있습니다.

질문3: 여러 개의 파이썬 버전을 사용할 수 있나요?
답변3: 네, VS Code와 아나콘다를 이용하면 각 프로젝트별로 다른 파이썬 버전을 설정하여 사용할 수 있습니다.

질문4: 자동 저장 설정은 어떻게 하나요?
답변4: File > Preferences > Settings에서 Files: Auto Save를 찾아 원하는 주기를 설정하면 됩니다.

질문5: VS Code에서 디버깅 기능은 어떻게 사용하나요?
답변5: 디버깅을 위해서는 왼쪽 사이드바의 디버그 아이콘을 클릭 후, Run and Debug를 선택합니다. 원하는 디버거나 환경을 설정할 수 있습니다.