이 출시되었습니다! 11월의 새로운 기능 및 수정 사항을 읽어보세요.

Visual Studio Code의 Python

Visual Studio Code에서 Python을 사용하는 것은 Microsoft Python 확장을 통해 간단하고 즐거우며 생산적입니다. 이 확장은 VS Code를 훌륭한 Python 편집기로 만들어 주며, 다양한 Python 인터프리터와 함께 모든 운영 체제에서 작동합니다. VS Code의 모든 기능을 활용하여 자동 완성 및 IntelliSense, 린팅, 디버깅, 단위 테스트를 제공하며, 가상 환경 및 conda 환경을 포함한 Python 환경 간을 쉽게 전환할 수 있습니다.

이 문서에서는 VS Code용 Python 확장 기능의 다양한 기능에 대한 개요만 제공합니다. 코드 편집, 실행 및 디버깅에 대한 자세한 내용은 아래 버튼을 사용하세요.

Python 튜토리얼

Python 및 Python 확장 설치

튜토리얼은 Python 설치 및 확장에서의 사용법을 안내합니다. 확장 프로그램과 별도로 Python 인터프리터를 직접 설치해야 합니다. 빠른 설치를 위해 python.org의 Python을 사용하고 VS Code Marketplace에서 확장을 설치하세요.

참고: Python 개발을 시작하는 데 도움이 되도록 유용한 확장, 설정 및 Python 코드 스니펫을 포함하는 Python 프로필 템플릿을 사용할 수 있습니다.

Python 버전을 설치한 후에는 **Python: 인터프리터 선택** 명령을 사용하여 선택하세요. VS Code가 찾고 있는 인터프리터를 자동으로 찾지 못하면 환경 - 인터프리터 수동 지정을 참조하세요.

Python 확장은 설정을 통해 구성할 수 있습니다. 자세한 내용은 Python 설정 참조에서 확인하세요.

Windows Subsystem for Linux: Windows를 사용 중이라면 WSL은 Python 개발에 훌륭한 방법입니다. Windows에서 Linux 배포판을 실행할 수 있으며 Python은 종종 이미 설치되어 있습니다. WSL 확장을 사용하면 WSL 컨텍스트에서 실행하면서 VS Code의 전체 편집 및 디버깅 지원을 받을 수 있습니다. 자세한 내용은 WSL에서 개발하기를 참조하거나 WSL에서 작업하기 튜토리얼을 시도해 보세요.

Python 코드 실행

Python을 경험하려면 (파일 탐색기를 사용하여) hello.py라는 파일을 만들고 다음 코드를 붙여넣으세요.

print("Hello World")

그러면 Python 확장이 현재 선택된 인터프리터를 사용하여 Python 코드를 실행하는 바로 가기를 제공합니다 (명령 팔레트에서 **Python: 인터프리터 선택**). 활성 Python 파일을 실행하려면 편집기 오른쪽 상단에 있는 **Python 파일 실행** 재생 버튼을 클릭하세요.

Using the run python file in terminal button

또한 **Python: 선택 사항/줄을 Python 터미널에서 실행** 명령 (Shift+Enter)을 사용하여 개별 줄이나 코드 선택 사항을 실행할 수 있습니다. 선택 사항이 없으면 Smart Send는 커서가 있는 줄 주변의 가장 작은 실행 가능한 코드 블록을 Python 터미널로 보냅니다 (Shift+Enter). 편집기에서 선택한 항목의 컨텍스트 메뉴에서도 동일한 **Python 실행 > 선택 사항/줄을 Python 터미널에서 실행** 명령을 사용할 수 있습니다. 터미널/REPL에서 줄이나 선택 사항을 실행할 때마다 해당 터미널이 닫힐 때까지 동일한 터미널이 사용됩니다. **터미널에서 Python 파일 실행**에도 동일한 터미널이 사용됩니다. 해당 터미널에서 REPL이 계속 실행 중이라면 REPL을 종료 (exit())하거나 Python 파일을 실행하기 전에 다른 터미널로 전환해야 합니다.

Python 확장은 선택한 첫 번째 비어 있지 않은 줄을 기준으로 들여쓰기를 자동으로 제거하고, 필요에 따라 다른 모든 줄을 왼쪽으로 이동합니다.

이 명령은 필요한 경우 Python 터미널을 엽니다. **Python: 터미널 REPL 시작** 명령을 사용하여 대화형 REPL 환경을 직접 열 수도 있습니다. 이 명령은 현재 선택된 인터프리터로 터미널을 활성화한 다음 Python REPL을 실행합니다.

더 구체적인 안내 및 코드 실행 방법은 코드 실행 튜토리얼을 참조하세요.

자동 완성 및 IntelliSense

Python 확장은 현재 선택된 인터프리터를 사용하여 코드 완성 및 IntelliSense를 지원합니다. IntelliSense는 지능형 코드 완성 (컨텍스트 내 메서드 및 변수 제안)을 포함한 여러 기능으로, 모든 파일 및 내장/타사 모듈에 걸쳐 적용됩니다.

IntelliSense는 입력하는 동안 메서드, 클래스 멤버 및 문서를 빠르게 표시합니다. ⌃Space (Windows, Linux Ctrl+Space)로 언제든지 자동 완성을 트리거할 수도 있습니다. 식별자에 마우스를 올리면 더 많은 정보를 볼 수 있습니다.

IntelliSense and autocomplete for Python code

AI로 완성도 향상

GitHub Copilot은 코드를 더 빠르고 스마트하게 작성하도록 도와주는 AI 기반 코드 완성 도구입니다. VS Code의 GitHub Copilot 확장을 사용하여 코드를 생성하거나 생성된 코드를 통해 배울 수 있습니다.

GitHub Copilot extension in the VS Code Marketplace

GitHub Copilot은 Python 외에도 JavaScript, TypeScript, Ruby, Go, C# 및 C++를 포함한 다양한 프레임워크에 대한 제안을 제공합니다.

Copilot 시작 방법에 대한 자세한 내용은 Copilot 설명서에서 확인할 수 있습니다.

린팅

린팅은 Python 코드의 잠재적인 오류를 분석하여 문제를 쉽게 탐색하고 수정할 수 있도록 합니다.

Python 확장은 Pylint, pycodestyle, Flake8, mypy, pydocstyle, prospector, pylama를 포함한 다양한 린터를 적용할 수 있습니다. 린팅을 참조하세요.

디버깅

더 이상 print 문 디버깅은 필요 없습니다! VS Code는 Python Debugger 확장을 통해 Python에 대한 훌륭한 디버깅 지원을 제공하여 중단점을 설정하고, 변수를 검사하고, 디버그 콘솔을 사용하여 프로그램 실행 과정을 단계별로 자세히 살펴볼 수 있습니다. 다중 스레드, 웹 및 원격 애플리케이션을 포함한 다양한 유형의 Python 애플리케이션을 디버깅하세요.

launch.json 설정 구성 및 원격 디버깅 구현과 같은 Python 디버깅에 대한 자세한 내용은 디버깅을 참조하세요. 일반적인 VS Code 디버깅 정보는 디버깅 문서에서 찾을 수 있습니다.

또한 DjangoFlask 튜토리얼은 Django 템플릿 디버깅을 포함하여 웹 애플리케이션 컨텍스트에서 디버깅을 구현하는 방법에 대한 예제를 제공합니다.

환경

Python 확장은 표준 위치에 설치된 Python 인터프리터를 자동으로 감지합니다. 또한 작업 영역 폴더의 conda 환경 및 가상 환경도 감지합니다. Python 환경 구성을 참조하세요.

현재 환경은 VS Code 상태 표시줄의 오른쪽에 표시됩니다.

Status Bar showing a selected interpreter

상태 표시줄은 인터프리터가 선택되지 않은 경우에도 표시합니다.

Status bar showing no selected Python interpreter

선택된 환경은 IntelliSense, 자동 완성, 린팅, 형식 지정 및 기타 언어 관련 기능에 사용됩니다. 또한 터미널에서 Python을 실행하거나 디버깅할 때, 또는 **터미널: 새 터미널 만들기** 명령으로 새 터미널을 만들 때 활성화됩니다.

상태 표시줄의 인터프리터 이름을 선택하거나 **Python: 인터프리터 선택** 명령을 사용하여 현재 인터프리터를 변경하세요. 여기에는 conda 또는 가상 환경으로 전환하는 것이 포함됩니다.

Python: Select Interpreter command

VS Code는 감지된 환경 목록과 사용자 설정에 수동으로 추가한 환경 ( Python 환경 구성 참조)을 보여줍니다.

Jupyter 노트북

VS Code에서 Jupyter 노트북 파일 (.ipynb)에 대한 Python 지원을 사용하려면 Jupyter 확장을 설치할 수 있습니다. Python 확장과 Jupyter 확장은 함께 작동하여 VS Code에서 훌륭한 노트북 경험을 제공하며, IntelliSense 지원을 통해 코드 셀을 직접 보고 수정하며, 실행 및 디버깅할 수 있습니다.

Jupyter notebook running in VS code in the Notebook Editor

또한 **Jupyter: Python 스크립트로 내보내기** 명령을 통해 노트북을 Python 코드 파일로 변환하고 열 수 있습니다. 노트북의 셀은 Python 파일에서 #%% 주석으로 구분되며, Jupyter 확장은 **셀 실행** 또는 **아래 실행** CodeLens를 표시합니다. CodeLens를 선택하면 Jupyter 서버가 시작되고 Python 대화형 창에서 셀이 실행됩니다.

Jupyter notebook running in VS Code and the Python interactive window

원격 Jupyter 서버에 연결하여 노트북을 실행할 수도 있습니다. 자세한 내용은 Jupyter 지원을 참조하세요.

테스트

Python 확장은 Python의 내장 unittest 프레임워크 및 pytest를 사용한 테스트를 지원합니다.

테스트를 실행하려면 프로젝트 설정에서 지원되는 테스트 프레임워크 중 하나를 활성화해야 합니다. 각 프레임워크에는 테스트 검색 경로 및 패턴을 식별하기 위한 인수와 같은 특정 설정이 있습니다.

테스트가 검색되면 VS Code는 상태 표시줄, 명령 팔레트 및 기타 위치에서 테스트를 실행하고 디버그하는 다양한 명령을 제공합니다. 이러한 명령을 사용하면 개별 테스트 파일 및 메서드를 실행할 수도 있습니다.

구성

Python 확장은 다양한 기능에 대한 광범위한 설정을 제공합니다. 이러한 설정은 코드 편집, 린팅, 디버깅, 테스트와 같은 관련 주제에 설명되어 있습니다. 전체 목록은 설정 참조에서 찾을 수 있습니다.

Python 프로필 템플릿

프로필을 사용하면 현재 프로젝트 또는 작업에 따라 확장, 설정 및 UI 레이아웃을 빠르게 전환할 수 있습니다. Python 개발을 시작하는 데 도움이 되도록 유용한 확장, 설정 및 스니펫으로 구성된 큐레이션된 프로필인 Python 프로필 템플릿을 사용할 수 있습니다. 프로필 템플릿을 그대로 사용하거나 사용자 지정 워크플로를 위해 추가로 사용자 지정하는 시작점으로 사용할 수 있습니다.

프로필 > 프로필 만들기... 드롭다운을 통해 프로필 템플릿을 선택합니다.

Create Profile dropdown with profile templates

프로필 템플릿을 선택하면 설정과 확장을 검토하고 새 프로필에 포함하지 않으려는 개별 항목을 제거할 수 있습니다. 템플릿을 기반으로 새 프로필을 만든 후 설정, 확장 또는 UI에 대한 변경 사항은 프로필에 유지됩니다.

이 문서에서 설명한 모든 기능은 Microsoft Python 확장에서 제공합니다. 다른 인기 있는 Python 확장을 설치하여 VS Code에 추가 Python 언어 지원을 추가할 수 있습니다.

  1. 확장 보기 (⇧⌘X (Windows, Linux Ctrl+Shift+X))를 엽니다.
  2. 'python'을 입력하여 확장 목록을 필터링합니다.

위에 표시된 확장은 동적으로 쿼리됩니다. 확장 타일을 클릭하여 설명과 리뷰를 읽고 자신에게 가장 적합한 확장을 결정하세요. 자세한 내용은 Marketplace를 참조하세요.

다음 단계

© . This site is unofficial and not affiliated with Microsoft.