이 가이드는 Jack Fields의 아티클에서 큰 영감을 받았어. Python 개발을 위한 VS Code 설정에 대한 더 자세한 내용은 해당 아티클을 참고해줘.

​
사전 준비 사항

시작하기 전에 다음이 준비되어 있는지 확인해:
  • Python 설치(권장: 3.8 이상)
  • 버전 관리를 위한 Git
  • 최신 버전으로 업데이트된 Cursor

​
필수 확장 프로그램

다음 확장 프로그램은 Cursor를 Python 개발에 최적화된 풀 스택 기능으로 설정해 줘. 구문 하이라이팅, 린팅, 디버깅, 유닛 테스트를 제공해.

Python

Microsoft의 핵심 언어 지원

Cursor Pyright

빠른 Python 언어 서버

Python Debugger

향상된 디버깅 기능

Ruff

Python 린터 및 포매터

​
고급 Python 도구

위 확장 프로그램들이 그동안 Cursor에서 Python 개발에 가장 인기 있었지만, Python 개발 효율을 최대한 끌어올릴 수 있도록 추가 확장 프로그램도 넣었어.

​
uv - Python 환경 관리자

uv는 최신 Python 패키지 관리자야. 기본 패키지 관리자인 pip을 대체할 수 있을 뿐 아니라, 가상 환경을 생성하고 관리하는 데도 쓸 수 있어. uv를 설치하려면 터미널에서 다음 명령을 실행해: 
pip install uv

​
ruff - Python Linter와 Formatter

Ruff는 프로그래밍 오류를 검사하고, 코딩 표준 준수를 돕고, 리팩터링을 제안해 주는 최신 Python linter 겸 formatter야. 코드 포매팅엔 Black이랑 같이 써도 좋아. Ruff를 설치하려면 터미널에서 다음 명령을 실행해: 
pip install ruff

​
Cursor 설정

​
1. Python 인터프리터

Cursor에서 Python 인터프리터를 설정해:
  1. Command Palette 열기 (Cmd/Ctrl + Shift + P)
  2. “Python: Select Interpreter” 검색
  3. Python 인터프리터 선택 (가상환경을 쓰고 있다면 해당 환경 선택)

​
2. 코드 포매팅

Black으로 자동 코드 포매팅 설정:
Black은 코드를 자동으로 포매팅해 일관된 스타일을 맞춰주는 코드 포매터야. 별도 설정이 필요 없고 Python 커뮤니티에서 널리 쓰이고 있어.
Black을 설치하려면 터미널에서 다음 명령을 실행해: 
pip install black
그다음 settings.json 파일에 다음을 추가해서 코드 포매팅에 Black을 쓰도록 Cursor를 설정해줘: 
{
  "python.formatting.provider": "black",
  "editor.formatOnSave": true,
  "python.formatting.blackArgs": ["--line-length", "88"]
}

​
3. 린팅

PyLint로 프로그래밍 오류를 검사하고, 코딩 표준을 강제하며, 리팩터링을 제안받을 수 있어. PyLint를 설치하려면 터미널에서 아래 명령을 실행해: 
pip install pylint

{
  "python.linting.enabled": true,
  "python.linting.pylintEnabled": true,
  "python.linting.lintOnSave": true
}

​
4. 타입 체크

린팅 외에도 MyPy로 타입 오류를 확인할 수 있어. MyPy를 설치하려면 터미널에서 아래 명령을 실행해: 
pip install mypy

{
  "python.linting.mypyEnabled": true
}

​
디버깅

Cursor는 Python용 강력한 디버깅 기능을 제공해:
  1. 거터를 클릭해 브레이크포인트 설정하기
  2. 디버그 패널 사용하기 (Cmd/Ctrl + Shift + D)
  3. 커스텀 디버그 구성을 위해 launch.json 설정하기

Tab Completion

작업 흐름을 이해하는 지능형 코드 제안

Chat

자연스러운 대화로 코드를 탐색하고 이해하기

Agent

AI 도움으로 복잡한 개발 작업 처리

Context

서드파티 시스템의 컨텍스트 끌어오기

Auto-Imports

코딩 중 모듈 자동 임포트

AI Review

Cursor가 AI로 코드를 계속 리뷰해

​
프레임워크 지원

Cursor는 인기 있는 Python 프레임워크와 자연스럽게 호환돼:
  • 웹 프레임워크: Django, Flask, FastAPI
  • 데이터 사이언스: Jupyter, NumPy, Pandas
  • 머신러닝: TensorFlow, PyTorch, scikit-learn
  • 테스트: pytest, unittest
  • API: requests, aiohttp
  • 데이터베이스: SQLAlchemy, psycopg2