Python 코드 서식 지정Formatting Python code

Visual Studio에서는 미리 구성된 서식 옵션과 일치하도록 빠르게 코드 서식을 다시 지정할 수 있습니다.Visual Studio lets you quick reformat code to match pre-configured formatting options.

  • 선택 항목의 서식을 지정하려면 편집 > 고급 > 선택 영역 서식을 선택하거나 Ctrl+E, F를 누릅니다.To format a selection: select Edit > Advanced > Format Selection or press Ctrl+E,F.
  • 전체 파일의 서식을 지정하려면 편집 > 고급 > 문서 서식을 선택하거나 Ctrl+E, D를 누릅니다.To format the whole file: select Edit > Advanced > Format Document or press Ctrl+E,D.

옵션은 도구 > 옵션 > 텍스트 편집기 > Python > 서식 및 해당 중첩된 탭을 통해 설정되며, 기본적으로 PEP 8 스타일 가이드의 상위 집합과 일치하도록 설정됩니다.Options are set through Tools > Options > Text Editor > Python > Formatting and its nested tabs, and by default are set to match a superset of the PEP 8 style guide. 일반 탭은 서식을 적용할 시기를 결정하며, 다른 세 개의 탭에 대한 설정은 이 항목에서 설명합니다.The General tab determines when formatting is applied; settings the other three tabs are described in this topic.

Visual Studio의 Python 지원에는 다음에 설명하는 대로 편집 > 고급 메뉴에 유용한 주석 단락 채우기 명령도 추가되어 있습니다.Python support in Visual Studio also adds the useful Fill Comment Paragraph command to the Edit > Advanced menu as described that follow.

간격Spacing

간격은 다양한 언어 구문 주위에 공백이 삽입되거나 제거되는 위치를 제어합니다.Spacing controls where spaces are inserted or removed around various language constructs. 각 옵션에는 다음 세 가지 가능한 값이 있습니다.Each option has three possible values:

  • 선택한 상태: 간격을 적용합니다.Checked: ensures the spacing is applied.
  • 선택 취소됨: 모든 간격을 제거합니다.Cleared: removes any spacing.
  • 비활성화 상태: 원래 서식을 그대로 유지합니다.Indeterminate: leaves original formatting in place.

다양한 옵션에 대한 예제가 다음 표에 나와 있습니다.Examples for the various options are provided in the following tables:

클래스 정의 옵션Class Definitions option 선택한 상태Checked 선택 취소됨Cleared
클래스 선언의 이름과 베이스 목록 사이에 공백 삽입Insert space between a class declaration's name and bases list class X (object): pass class X(object): pass
베이스 목록 괄호 내에 공백 삽입Insert space within bases list parentheses class X( object ): pass class X(object): pass
빈 베이스 목록 괄호 내에 공백 삽입Insert space within empty bases list parentheses class X( ): pass class X(): pass


함수 정의 옵션Function Definitions option 선택한 상태Checked 선택 취소됨Cleared
함수 선언의 이름과 매개 변수 목록 사이에 공백 삽입Insert space between a function declaration's name and parameter list def X (): pass def X(): pass
매개 변수 목록 괄호 내에 공백 삽입Insert space within parameter list parentheses def X( a, b ): pass def X(a, b): pass
빈 매개 변수 목록 괄호 내에 공백 삽입Insert space within empty parameter list parentheses def X( ): pass def X(): pass
기본 매개 변수 값의 '=' 주위에 공백 삽입Insert spaces around '=' in default parameter values includes X(a = 42): pass includes X(a=42): pass
반환 주석 연산자 앞뒤에 공백 삽입Insert space before and after return annotation operators includes X() -> 42: pass includes X()->42: pass


연산자 옵션Operators option 선택한 상태Checked 선택 취소됨Cleared
이항 연산자 주위에 공백 삽입Insert spaces around binary operators a + b a+b
할당 연산자 주위에 공백 삽입Insert spaces around assignments a = b a=b


식 간격 옵션Expression spacing option 선택한 상태Checked 선택 취소됨Cleared
함수 호출의 이름과 인수 목록 사이에 공백 삽입Insert space between a function call's name and argument list X () X()
빈 인수 목록 괄호 내부에 공백 삽입Insert space within empty argument list parentheses X( ) X()
인수 목록 괄호의 내부에 공백 삽입Insert space within argument list parentheses X( a, b ) X(a, b)
식 괄호 내에 공백 삽입Insert space within parentheses of expression ( a ) (a)
빈 튜플 괄호 내에 공백 삽입Insert space within empty tuple parentheses ( ) ()
튜플 괄호 내에 공백 삽입Insert space within tuple parentheses ( a, b ) (a, b)
빈 대괄호의 내부에 공백 삽입Insert space within empty square brackets [ ] []
목록 대괄호 내에 공백 삽입Insert spaces within square brackets of lists [ a, b ] [a, b]
여는 대괄호 앞에 공백 삽입Insert space before open square bracket x [i] x[i]
대괄호 내부에 공백을 삽입합니다.Insert space within square brackets x[ i ] x[i]


Statements

옵션은 다양한 문을 더 많은 Python 양식으로 자동으로 다시 작성하는 것을 제어합니다.The Statements options control automatic rewriting of various statements into more Pythonic forms.

옵션Option 서식 지정 앞Before formatting 서식 지정 뒤After formatting
새 줄에 가져온 모듈 배치Place imported modules on new line import sys, pickle import sys
import pickle
불필요한 세미콜론 제거Remove unnecessary semicolons x = 42; x = 42
새 줄에 여러 문 배치Place multiple statements on new lines x = 42; y = 100 x = 42
y = 100

줄 바꿈Wrapping

줄 바꿈을 사용하여 최대 주석 너비(기본값: 80)를 설정할 수 있습니다.Wrapping lets you set the Maximum comment width (default is 80). 너무 넓은 주석 줄 바꿈 옵션을 설정하는 경우 Visual Studio에서 최대 너비를 초과하지 않도록 주석의 서식을 다시 지정합니다.If the Wrap comments that are too wide option is set, Visual Studio reformats comments to not exceed that maximum width.

# Wrapped to 40 columns
# There should be one-- and preferably
# only one --obvious way to do it.
# Not-wrapped:
# There should be one-- and preferably only one --obvious way to do it.

주석 단락 채우기 명령Fill Comment Paragraph command

편집 > 고급 > 주석 단락 채우기(Ctrl+E, P)는 주석 텍스트를 다시 배치하고, 해당 서식을 지정하며, 짧은 줄을 결합하고, 긴 줄을 분리합니다.Edit > Advanced > Fill Comment Paragraph (Ctrl+E, P) reflows and formats comment text, combining short lines together and breaking up long ones.

예:For example:

# foo 
# bar
# baz

다음으로 변경합니다.changes to:

# foo bar baz
# This is a very long long long long long long long long long long long long long long long long long long long comment

다음으로 변경합니다.changes to:

# This is a very long long long long long long long long long long long long
# long long long long long long long comment