Visual Studio의 Python 옵션

Visual Studio는 Python 개발을 위한 IDE(대화형 개발 환경) 구성을 지원합니다. 기본 설정에 따라 옵션을 설정하고 특정 개발 환경 요구 사항을 충족할 수 있습니다. 이 문서에서는 일반 레이아웃 및 동작, 디버깅, 진단, 고급 Python 언어 기능에 사용할 수 있는 옵션을 설명합니다.

Python 옵션 위치

Python 구성 설정은 도구>옵션 아래 Visual Studio 툴바에서 사용할 수 있습니다. 옵션 대화 상자에는 Python 탭의 Python에 대한 대부분의 설정이 나열됩니다.

디버깅, Pylance 언어 서버 분석, conda 환경, 일반 환경, 대화형 창의 기본 설정을 구성할 수 있습니다.

옵션 대화 상자에는 텍스트 편집기>Python의 다른 Python 설정이 나열됩니다. 일반 및 고급 설정과 함께 스크롤 막대, 탭, 서식에 대한 옵션이 있습니다. 다른 설정은 텍스트 편집기 설정 그룹의 환경>글꼴 및 색에서 사용할 수 있습니다.

참고 항목

옵션 대화 상자에는 이 문서에 설명되지 않은 개발 중인 기능에 대한 실험 탭 또는 그룹이 포함될 수 있습니다. Microsoft 블로그의 Python 엔지니어링 게시물에서 자세한 정보를 찾을 수 있습니다.

Python용 특정 옵션

도구>옵션>Python에서 대화형 창, conda 환경, 디버깅 등을 비롯한 일반 환경에 대한 Python 관련 옵션을 설정할 수 있습니다.

일반 Python 옵션

다음 옵션은 도구>옵션>Python>일반에서 사용할 수 있습니다.

옵션	기본값	설명
가상 환경을 만들 때 출력 창 표시	켜기	출력 창이 표시되지 않도록 하려면 선택 취소합니다.
패키지를 설치하거나 제거할 때 출력 창 표시	켜기	출력 창이 표시되지 않도록 하려면 선택 취소합니다.
환경 만들기에 대한 알림 표시줄 표시	켜기	이 옵션을 설정하고 requirements.txt 또는 environment.yml 파일이 포함된 프로젝트를 열면 Visual Studio는 기본 글로벌 환경을 사용하지 않고 가상 환경 또는 Conda 환경을 만들기 위한 각각의 제안이 포함되어 있는 알림 표시줄을 보여줍니다.
패키지 설치에 대한 알림 표시줄 표시	켜기	이 옵션을 설정하고 requirements.txt 파일(기본 글로벌 환경을 사용하지 않음)이 포함된 프로젝트를 열면, Visual Studio가 해당 요구 사항을 현재 환경에 설치된 패키지와 비교합니다. 패키지가 누락된 경우에는 Visual Studio에서 해당 종속성을 설치하라는 메시지를 표시합니다.
테스트 프레임워크를 구성하도록 알림 표시줄 표시	설정	이 옵션을 설정하면 Visual Studio가 테스트를 포함할 수 있지만 사용 가능한 테스트 프레임워크가 없는 파일을 Python 프로젝트에서 검색한 경우 Visual Studio에서 pytest 또는 unittest를 사용하도록 설정하라는 메시지를 표시합니다.
항상 관리자로 패키지 관리자 실행	끄기	항상 모든 환경에서 pip install 및 유사한 패키지 관리자 작업 권한을 상승합니다. 패키지를 설치할 때 환경이 c:\Program Files와 같은 파일 시스템의 보호된 영역에 있을 경우 Visual Studio에서 관리자 권한을 확인하는 메시지를 표시합니다. 해당 메시지에서 하나의 환경에 대해서만 항상 설치 명령 권한을 상승하도록 선택할 수 있습니다. 자세한 내용은 패키지 탭을 참조하세요.

Conda 환경 옵션

다음 옵션은 도구>옵션>Python>Conda에서 사용할 수 있습니다.

옵션	기본값	설명
Conda 실행 파일 경로	(비어 있음)	Python 워크로드에 포함된 기본 Miniconda 설치를 사용하지 않고 conda.exe 실행 파일의 정확한 경로를 지정합니다. 여기에 다른 경로가 지정되면 기본 설치 및 레지스트리에 지정된 기타 모든 conda.exe 실행 파일보다 이 경로가 먼저 적용됩니다. 최신 버전의 Anaconda 또는 Miniconda를 수동으로 설치하거나 기본 64비트 배포판이 아닌 32비트 배포판을 사용하려는 경우 이 설정을 변경할 수 있습니다.

디버깅 옵션

다음 옵션은 도구>옵션>Python>디버깅에서 사용할 수 있습니다.

옵션	기본값	설명
오류가 있으면 실행 전에 묻기	켜기	이 옵션을 설정하면 Visual Studio에서 오류가 포함된 코드를 실행할 것인지 확인하는 메시지를 표시합니다. 경고를 사용하지 않으려면 이 옵션의 선택을 취소합니다.
프로세스가 비정상적으로 종료되면 입력 대기 프로세스가 정상적으로 종료되면 입력 대기	켜짐(모두)	Visual Studio에서 시작된 Python 프로그램은 자체 콘솔 창에서 실행됩니다. 기본적으로 프로그램 종료 방법과 관계없이 창을 닫기 전에 사용자가 키를 누를 때까지 대기합니다. 프롬프트를 제거하고 창을 자동으로 닫으려면 이러한 옵션 중 하나 또는 둘 다의 선택을 취소합니다.
디버그 출력 창에 Tee 프로그램 출력	켜기	별도 콘솔 창과 Visual Studio 출력 창에 프로그램 출력을 표시합니다. 별도 콘솔 창에만 출력을 표시하려면 이 옵션의 선택을 취소합니다.
SystemExit 예외에서 중단하고 종료 코드로 0 출력	끄기	설정하면 이 예외에서 디버거를 중지합니다. 선택 취소하면 디버거가 중단되지 않고 종료됩니다.
Python 표준 라이브러리 디버깅 사용	끄기	디버깅하는 동안 표준 라이브러리 소스 코드를 한 단계씩 실행할 수 있지만 디버거를 시작하는 데 걸리는 시간이 증가합니다.
함수 반환 값 표시	켜기	지역 창에 함수 반환 값을 표시한 후 디버거(F10)의 함수 호출을 건너뜁니다.
변수 표시	설정	표시할 변수 그룹 4개와 표시 서식 지정 방법(그룹, 숨기기, 인라인)을 표시합니다. - 클래스: 기본값은 "그룹"입니다. - 보호됨: 기본값은 "인라인"입니다. - 함수: 기본값은 "그룹"입니다. - 특수: 기본값은 "그룹"입니다.

분석 옵션

다음 옵션은 도구>옵션>Python>분석에서 사용할 수 있습니다.

옵션	기본값	설명
진단 모드	파일만 열기	작업 영역 및 파일만 열기를 포함하여 언어 서버가 문제에 대해 분석하는 코드 파일을 지정합니다.
로그 수준	정보	언어 서버에서 수행할 로깅 수준을 지정합니다. 제공된 정보 수준이 늘어남에 따라 가능한 로깅 수준으로, 오류, 경고, 정보, 추적이 포함됩니다.
형식 검사	끄기	수행할 형식 검사 분석 수준을 지정합니다. - 끄기: 해결되지 않은 가져오기/변수 진단을 생성하지만 형식 검사 분석은 수행하지 않습니다. - 기본: 형식 외(끄기 수준 아래 모든 규칙) 및 기본 형식 검사 관련 규칙도 사용합니다. - 엄격: 끄기 및 기본 수준 둘 다의 아래에 있는 모든 규칙을 포함하여 오류 심각도가 가장 높은 모든 형식 검사 규칙을 사용합니다.
가져오기 형식	절대값	절대 또는 상대 모듈을 포함하여 모듈을 자동으로 가져올 때 기본 형식을 정의합니다.
스텁 경로	<Empty>	사용자 지정 형식 스텁을 포함하는 디렉터리의 경로를 지정합니다. 각 패키지에 대한 형식 스텁 파일은 자체 하위 디렉터리에 있어야 합니다.
검색 경로	<Empty>	가져오기 확인에 대한 검색 경로를 지정합니다. 여러 경로가 있는 경우 문자열로 지정되고 쉼표로 구분된 경로를 허용합니다(예: ["path 1","path 2"]).
Typeshed 경로	<Empty>	Visual Studio에서 번들형 버전 대신 사용자 지정 Typeshed 파일을 사용할 경로를 지정합니다.
'src'와 같은 일반 검색 경로 자동 추가	설정	미리 정의된 이름을 기반으로 검색 경로를 자동으로 추가할지 여부를 나타냅니다(예: src).
자동 가져오기, 가져오기 추가, 작업 영역 기호 등과 같은 언어 기능에 대해 설치된 제3자 라이브러리 및 사용자 파일 인덱싱	끄기	언어 서버가 시작 시 사용자 파일을 인덱싱하고 제3자 라이브러리를 설치해야 하는지 여부를 지정합니다. 인덱스는 자동 가져오기, 빠른 수정, 자동 완성 등을 비롯한 기능의 보다 완전한 기호 세트를 제공합니다. - 이 옵션을 설정하면 Visual Studio는 최대 2,000개 사용자 파일의 모든 기호와 함께, 설치된 패키지의 최상위 기호(예: package/__init__.py 아래 all의 기호)를 인덱싱합니다. - 이 옵션을 설정하지 않으면 Visual Studio는 이전에 편집기에서 열거나 로드한 파일에서 참조되거나 사용된 기호를 표시합니다.

대화형 Windows 옵션

다음 옵션은 도구>옵션>Python>대화형 창에서 사용할 수 있습니다.

옵션	기본값	설명
스크립트	N/A	모든 환경에서 대화형 창에 적용할 시작 스크립트의 일반 폴더를 지정합니다. 자세한 내용은 시작 스크립트를 참조하세요. 참고: 이 기능은 사용자의 Visual Studio 버전에서 작동하지 않을 수 있습니다.
위쪽/아래쪽 화살표로 기록 탐색	켜기	화살표 키를 사용하여 대화형 창의 기록을 탐색합니다. 화살표 키를 사용하여 대화형 창의 출력 내에서 탐색하려면 이 설정의 선택을 취소합니다.
완료 모드	함수 호출이 없는 식만 평가	대화형 창에서 식에 사용 가능한 구성원을 확인하는 프로세스를 수행하려면 현재 완료되지 않은 식을 평가해야 할 수 있으며, 이로 인해 부작용이 발생하거나 함수가 여러 번 호출될 수 있습니다. 기본 설정인 함수 호출이 없는 식만 평가는 함수를 호출하는 것으로 보이는 식을 제외하지만 다른 식은 평가합니다. 예를 들어 a.b 문을 평가하지만 a().b 문은 평가하지 않습니다. 식 평가 안 함은 일반적인 IntelliSense 엔진만 제안에 사용하여 모든 부작용을 방지합니다. 모든 식 평가는 부작용과 관계없이 전체 식을 평가하여 제안을 가져옵니다.
정적 분석 제안 숨기기	끄기	설정하면 식을 평가하여 얻은 제안만 표시합니다. 완료 모드 값 식 평가 안 함과 함께 사용할 경우 대화형 창에 유용한 완료가 나타나지 않습니다.

Python용 텍스트 편집기 옵션

텍스트 편집기>Python 아래에는 일반 및 고급 설정과 함께 스크롤 막대, 탭 및 서식 지정 옵션이 있습니다.

일반 Python 편집기 옵션

다음 옵션은 도구>옵션>텍스트 편집기>Python>일반에서 사용할 수 있습니다.

옵션	기본값	설명
멤버 목록 자동 표시	설정	코드 문 완성을 위해 구성원을 자동으로 나열하려면 이 옵션을 설정합니다.
고급 멤버 숨기기	설정	구성원 자동 나열 옵션을 사용하도록 설정하면 완성 제안에서 고급 구성원을 숨기도록 이 옵션을 설정합니다. 고급 구성원은 다른 구성원보다 사용 빈도가 낮은 구성원입니다.
매개 변수 정보	설정	옵션을 설정할 때 매개 변수에 마우스를 대면 항목 정의 및 설명서 링크와 같은 자세한 정보가 표시됩니다.
가상 공간 활성화	설정	설정되면 각 코드 줄의 끝에 공백을 삽입합니다. 코드 옆의 일정한 지점에 주석을 배치하려면 이 옵션을 선택합니다. 가상 공간 모드는 열 선택 모드에서 사용할 수 있습니다. 가상 공간 모드가 사용하도록 설정되지 않으면 삽입 지점이 한 줄 끝에서 바로 다음 줄의 첫 번째 문자로 이동합니다. 참고: 이 옵션은 텍스트 편집기>모든 언어>일반>가상 공간 사용 글로벌 설정의 영향을 받습니다. 글로벌 설정을 사용하도록 설정하지 않으면 언어 수준에서 이 옵션을 사용할 수 없습니다.
단어 줄 바꿈	끄기	편집기 뷰포트 너비에 따라 긴 코드 줄을 줄 바꿈하려면 이 옵션을 설정합니다.
자동 줄 바꿈 시각 문자 표시	끄기	자동 줄 바꿈 옵션을 사용하도록 설정하면 시각적 문자 모양을 표시하도록 이 옵션을 설정합니다.
줄 번호	끄기	각 코드 줄에서 편집기의 왼쪽 여백에 줄 번호를 표시하려면 이 옵션을 설정합니다.
한 번 클릭으로 URL 탐색	설정	이 옵션을 설정하면 URL을 한 번 클릭하여 대상 위치로 이동할 수 있습니다.
탐색 모음	끄기	코드 창의 맨 위에 있는 드롭다운 상자를 사용하도록 설정하려면 이 옵션을 설정합니다. 이러한 필드는 직접 이동할 형식 또는 구성원을 선택할 수 있는 코드베이스의 코드로 이동하는 데 도움이 됩니다. 참고: 이 옵션은 텍스트 편집기>모든 언어>일반>탐색 모음 사용 글로벌 설정의 영향을 받습니다. 자세한 내용은 코드 탐색> 탐색 모음을 참조하세요.
자동 중괄호 완료	설정	이 옵션을 설정하면 Visual Studio는 코드를 입력할 때 모든 여는 중괄호에 대한 닫는 중괄호를 자동으로 추가합니다.
선택 영역이 없는 경우 잘라내기 또는 복사를 빈 줄에 적용	설정	기본값으로 Visual Studio는 명시적 선택 항목이 없는 경우 전체 코드 줄을 잘라내거나 복사합니다. 빈 줄에서 호출될 때 이 잘라내기 또는 복사 동작을 사용하거나 사용하지 않도록 설정하려면 이 옵션을 사용합니다.

자세한 내용은 옵션 대화 상자: 텍스트 편집기 > 일반을 참조하세요.

고급 Python 편집기 옵션

다음 옵션은 도구>옵션>텍스트 편집기>Python>고급에서 사용할 수 있습니다.

옵션	기본값	설명
자동 가져오기 완성 제공	설정	이 옵션을 설정하면 Visual Studio는 완성 시 자동 가져오기 기능을 제공합니다.
함수에 대괄호 자동 추가	끄기	이 옵션을 설정하면 Visual Studio는 편집기에서 코드를 입력할 때 함수에 대괄호를 자동으로 추가합니다.

글꼴 및 색 옵션

텍스트 편집기 그룹이 Python으로 설정된 경우 환경>글꼴 및 색 아래에서 다른 Python 옵션을 사용할 수 있습니다.

Python 옵션의 이름은 모두 “Python”으로 시작하며 이해하기 쉽습니다. 모든 Visual Studio 색 테마의 기본 글꼴은 10pt Consolas 보통 글꼴(굵은 글꼴 아님)입니다. 기본 색은 테마에 따라 다릅니다. 일반적으로 텍스트를 더 쉽게 읽을 수 있도록 글꼴 또는 색을 변경합니다.