[도구/환경#1] VSCode 빠른 세팅 (확장, 단축키, 디버깅)

한줄 요약:
VSCode로 파이썬 개발 환경을 빠르게 설정하고, 확장과 디버깅 기능을 최적화해보자!
👉 설정, 확장, 단축키로 효율적인 파이썬 개발 시작 🔥

컨텐츠 목차

1. 목표

VSCode에서 파이썬 개발 환경 세팅
파이썬 코드 디버깅 설정
코드 작성 시 더 효율적으로 작업할 수 있는 확장 프로그램 설치

2. VSCode 설치 및 기본 설정

다운로드링크 : VSCode Download

VSCode 다운로드
VSCode 다운로드 페이지에서 운영체제에 맞는 설치파일을 다운로드 후 설치합니다.
파이썬 확장 설치
- VSCode를 실행하고 Extensions(확장 프로그램) 뷰를 열어(Ctrl+Shift+X)
- 검색창에 Python을 검색하여 Microsoft의 파이썬 확장을 설치합니다.
파이썬 인터프리터 선택
- 상단 메뉴에서 View > Command Palette를 선택하거나 Ctrl+Shift+P 입력
- Python: Select Interpreter를 선택 후 원하는 파이썬 인터프리터를 선택합니다.
  (가상환경을 사용 중이라면 그 환경을 선택해 주세요.)
터미널 기본 설정
- VSCode 터미널에서 파이썬 명령어(python 또는 python3)가 바로 실행되도록 설정
- Terminal > New Terminal을 클릭하거나 Ctrl+~`로 터미널을 엽니다.

3. VSCode 확장 프로그램 설치 (추천 확장 5개)

Python
Microsoft에서 제공하는 공식 파이썬 확장. IntelliSense(자동완성), Linting(문법 검사), 디버깅 등 지원.
Pylance
빠르고 강력한 파이썬 코드 분석 및 IntelliSense 기능을 제공하는 확장. Python 확장과 함께 설치되므로 바로 사용할 수 있어요.
autopep8 / black
자동 코드 포맷팅 도구입니다. PEP 8 스타일 가이드에 맞게 코드를 자동으로 정리해줍니다.
- autopep8: 자동으로 코드 스타일에 맞게 정리
- black: 더 엄격한 코드 스타일 적용
Jupyter
Jupyter 노트북 파일(.ipynb)을 VSCode에서 바로 실행하고 편집할 수 있게 해주는 확장입니다. 데이터 과학, 머신러닝 작업 시 유용합니다.
Code Runner
코드 파일을 한 번의 클릭으로 실행할 수 있도록 해주는 확장. 여러 언어를 지원하며, 파이썬도 바로 실행 가능!

4. 유용한 단축키

파일/폴더 열기
- Ctrl+O: 파일 열기
- Ctrl+Shift+E: 탐색기 열기 (파일/폴더 목록)
디버깅 시작/중지
- F5: 디버깅 시작
- Shift+F5: 디버깅 중지
코드 포맷팅
- Shift+Alt+F: 코드 자동 포맷팅
- Ctrl+Shift+P → Format Document: 문서 전체 포맷
주석 처리
- Ctrl+/: 한 줄 주석
- Shift+Alt+A: 여러 줄 주석
디버깅 중 변수 값 보기
- Ctrl+Shift+Y: 디버그 콘솔 보기
- F10: 한 줄 실행 (현재 줄에서 다음 줄로 이동)
- F11: 함수 내부로 들어가기

5. 디버깅 설정

1️⃣ 기본 디버깅 시작

디버그 패널을 열고(Ctrl+Shift+D), 좌측 상단에서 Run and Debug 클릭
디버그 설정이 없으면 자동으로 launch.json 파일이 생성됩니다. 기본 설정은 현재 실행 중인 파일을 디버깅합니다.

2️⃣ `launch.json` 수정 (디버깅 설정 커스터마이징)

디버깅 시, 특정 파이썬 파일이나 인수를 지정할 수 있습니다.
예를 들어, 특정 스크립트를 실행하고 싶다면 launch.json을 아래처럼 수정할 수 있어요:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Current File",
      "type": "python",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal"
    }
  ]
}

3️⃣ 중단점(Breakpoint) 설정

왼쪽 여백을 클릭하여 코드 라인에 빨간 점을 찍으면 중단점이 설정됩니다.
디버깅 실행 시, 해당 줄에서 코드 실행이 멈추고 변수 값 확인 등을 할 수 있습니다.

6. VSCode 최적화 팁

1️⃣ 자동화된 코드 정리

자동 포맷: 코드 작성 후 자동으로 포맷팅할 수 있도록 설정.
- settings.json에서 아래 설정 추가:
"[python]": { "editor.formatOnSave": true }

2️⃣ Python 인터프리터 관리

가상환경을 만들면, 프로젝트마다 서로 다른 패키지 버전과 모듈을 관리할 수 있어요.
가상환경을 만들고 VSCode에서 해당 환경을 선택하면, 프로젝트에 맞는 파이썬 인터프리터가 자동으로 설정됩니다.

3️⃣ Git과 연동

Git을 사용할 때 VSCode의 Git 기능을 활용하면, 코드 변경 사항을 바로 트래킹하고 푸시할 수 있습니다.
- Ctrl+Shift+G로 Git 변경사항 보기
- .gitignore 파일에 *.pyc, __pycache__/ 등을 추가해 불필요한 파일을 제외

7. 자주 묻는 질문(FAQ)

Q. 디버깅 중 프로그램이 멈춰요, 왜 그런가요?
A. **중단점(Breakpoint)**이 활성화되었을 가능성 있습니다. 중단점을 제거하거나, 디버깅을 계속하려면 F5를 눌러주세요.

Q. 코드 자동완성이 잘 안 돼요, 어떻게 해결하죠?
A. Python 확장 프로그램과 Pylance 확장이 설치되어 있는지 확인하세요.

Ctrl+Shift+P → Python: Select Interpreter로 올바른 인터프리터가 선택되었는지 확인.

Q. 가상환경이 잘 안 되나요?
A. 가상환경을 생성하고 활성화한 후, VSCode에서 해당 환경을 선택해야 합니다.

Ctrl+Shift+P → Python: Select Interpreter → 가상환경 선택

8. 요약 한 줄

VSCode는 확장 프로그램 + 단축키로 파이썬 개발을 빠르고 효율적으로 만들어주는 툴입니다! 디버깅과 가상환경 설정까지, 파이썬 개발을 더욱 강력하게 만들어 보세요.

이전 강좌 👈 [에러#4] ImportError: cannot import name ... 오류 정리
다음 강좌 👉 [도구/환경#2] 가상환경 & 패키지 관리 (venv, conda, pip)