Windows의 Visual Studio에서 Python 지원 설치 방법How to install Python support in Visual Studio on Windows

Visual Studio용 Python 지원(Visual Studio용 Python 도구 또는 PTVS라고도 함)을 설치하려면 Visual Studio 버전과 일치하는 섹션의 지침을 따릅니다.To install Python support for Visual Studio (also known as Python Tools for Visual Studio or PTVS), follow the instructions in the section that matches your version of Visual Studio:

설치 단계를 따른 후 Python 지원을 신속하게 테스트하려면 Alt+I를 누르고 2+2를 입력하여 Python 대화형 창을 엽니다.To quickly test Python support after following the installation steps, open the Python Interactive window by pressing Alt+I and entering 2+2. 4의 출력이 표시되지 않으면 수행한 단계를 다시 확인합니다.If you don't see the output of 4, recheck your steps.

Python 작업에는 템플릿을 검색하고, 템플릿 옵션을 입력하고, 프로젝트와 파일을 만들 수 있는 그래픽 사용자 인터페이스를 제공하는 유용한 Cookiecutter 확장 프로그램이 포함되어 있습니다.The Python workload includes the helpful Cookiecutter extension that provides a graphical user interface to discover templates, input template options, and create projects and files. 자세한 내용은 Cookiecutter 확장 사용을 참조하세요.For details, see Use Cookiecutter.

참고

Python 지원은 현재 Mac용 Visual Studio에서 사용할 수 없으며 Visual Studio Code를 통해 Mac 및 Linux에서 사용할 수 있습니다.Python support is not presently available in Visual Studio for Mac, but is available on Mac and Linux through Visual Studio Code. 질문과 대답을 참조하세요.See questions and answers.

Visual Studio 2019 및 Visual Studio 2017Visual Studio 2019 and Visual Studio 2017

  1. 최신 Visual Studio 설치 관리자를 다운로드하고 실행합니다.Download and run the latest Visual Studio installer. Visual Studio가 이미 설치되어 있는 경우 Visual Studio 설치 관리자를 실행하고 수정 옵션(Visual Studio 수정 참조)을 선택하고 2단계로 이동합니다.If you have Visual Studio installed already, run the Visual Studio Installer, select the Modify option (see Modify Visual Studio) and go to step 2.

    커뮤니티 에디션은 개인 개발자, 교실 학습, 학술 연구 및 오픈 소스 개발용입니다.The Community edition is for individual developers, classroom learning, academic research, and open source development. 다른 용도의 경우 Visual Studio 2019 Professional 또는 Visual Studio 2019 Enterprise를 설치합니다.For other uses, install Visual Studio 2019 Professional or Visual Studio 2019 Enterprise.

  2. 설치 관리자는 특정 개발 영역에 대한 관련 옵션의 그룹인 워크로드 목록을 제공합니다.The installer presents you with a list of workloads, which are groups of related options for specific development areas. Python의 경우 Python 개발 워크로드를 선택합니다.For Python, select the Python development workload.

    Visual Studio 설치 관리자의 Python 개발 작업

    선택 사항: 데이터 과학을 사용하는 경우 데이터 과학 및 분석 애플리케이션 워크로드도 고려합니다.Optional: if you're working with data science, also consider the Data science and analytical applications workload. 이 워크로드는 Python, R 및 F# 언어에 대한 지원을 포함합니다.This workload includes support for the Python, R, and F# languages. 자세한 내용은 데이터 과학 및 분석 애플리케이션 워크로드를 참조하세요.For more information, see Data science and analytical applications workload.

    참고

    Python 및 데이터 과학 워크로드는 Visual Studio 2017 버전 15.2 이상에서만 사용할 수 있습니다.The Python and Data Science workloads are available only with Visual Studio 2017 version 15.2 and later.

    선택 사항: 데이터 과학을 사용하는 경우 데이터 과학 및 분석 애플리케이션 워크로드도 고려합니다.Optional: if you're working with data science, also consider the Data science and analytical applications workload. 이 워크로드는 Python 및 F# 언어에 대한 지원을 포함합니다.This workload includes support for the Python and F# languages. 자세한 내용은 데이터 과학 및 분석 애플리케이션 워크로드를 참조하세요.For more information, see Data science and analytical applications workload.

  3. 설치 관리자의 오른쪽에서 필요한 경우 추가 옵션을 선택합니다.On the right side of the installer, chose additional options if desired. 기본 옵션을 적용하려면 이 단계를 건너뜁니다.Skip this step to accept the default options.

    Visual Studio 설치 관리자의 Python 개발 옵션

    Visual Studio 2019 설치 관리자의 Python 개발 옵션

    옵션Option 설명Description
    Python 배포Python distributions 작업하려는 Python 2, Python 3, Miniconda, Anaconda2 및 Anaconda3 분배의 32비트 및 64비트 변형과 같은 사용 가능한 옵션 조합을 선택합니다.Choose any combination of the available options, such as 32-bit and 64-bit variants of the Python 2, Python 3, Miniconda, Anaconda2, and Anaconda3 distributions that you plan to work with. 각각은 배포의 인터프리터, 런타임 및 라이브러리를 포함합니다.Each includes the distribution's interpreter, runtime, and libraries. 특히 Anaconda는 다양한 미리 설치된 패키지를 포함하는 개방형 데이터 과학 플랫폼입니다.Anaconda, specifically, is an open data science platform that includes a wide range of pre-installed packages. (배포를 추가하거나 제거하기 위해 언제든지 Visual Studio 설치 관리자로 돌아갈 수 있습니다.) 참고: Visual Studio 설치 관리자 외부에서 배포를 설치한 경우 여기서 해당 옵션을 선택할 필요가 없습니다.(You can return to the Visual Studio installer at any time to add or remove distributions.) Note: If you've installed a distribution outside of the Visual Studio installer, there's no need to check the equivalent option here. Visual Studio에서 기존 Python 설치를 자동으로 검색합니다.Visual Studio automatically detects existing Python installations. Python 환경 창을 참조하세요.See The Python Environments window. 또한 설치 관리자에 표시된 버전보다 최신 버전의 Python을 사용할 수 있는 경우 해당 버전을 별도로 설치할 수 있으며, Visual Studio에서 이를 검색합니다.Also, if a newer version of Python is available than what's shown in the installer, you can install that version separately and Visual Studio will detect it.
    Cookiecutter 템플릿 지원Cookiecutter template support Cookiecutter 그래픽 UI를 설치하여 템플릿을 검색하고, 템플릿 옵션을 입력하고, 프로젝트 및 파일을 만듭니다.Installs the Cookiecutter graphical UI to discover templates, input template options, and create projects and files. Cookiecutter 확장 사용을 참조하세요.See Use the Cookiecutter extension.
    Python 웹 지원Python web support Bottle, Flask 및 Django 프레임워크를 사용하는 프로젝트에 대한 템플릿과 함께 HTML, CSS 및 JavaScript 편집 지원을 포함하는 웹 개발용 도구를 설치합니다.Installs tools for web development including HTML, CSS, and JavaScript editing support, along with templates for projects using the Bottle, Flask, and Django frameworks. Python 웹 프로젝트 템플릿을 참조하세요.See Python web project templates.
    Python IoT 지원Python IoT support Python을 사용하여 Windows IoT Core 개발을 지원합니다.Supports Windows IoT Core development using Python.
    Python 네이티브 개발 도구Python native development tools C++ 컴파일러 및 Python에 대한 기본 확장을 개발하는 데 필요한 기타 구성 요소를 설치합니다.Installs the C++ compiler and other necessary components to develop native extensions for Python. Python용 C++ 확장 만들기를 참조하세요.See Create a C++ extension for Python. 또한 전체 C++ 지원을 사용하려면 C++를 사용한 데스크톱 개발 워크로드를 설치하세요.Also install the Desktop development with C++ workload for full C++ support.
    Azure Cloud Services 핵심 도구Azure Cloud Services core tools Python에서 개발자 Azure Cloud Services에 대한 추가 지원을 제공합니다.Provides additional support for developer Azure Cloud Services in Python. Azure Cloud Service 프로젝트를 참조하세요.See Azure cloud service projects.
    옵션Option 설명Description
    Python 배포Python distributions 작업하려는 Python 2, Python 3, Miniconda, Anaconda2 및 Anaconda3 분배의 32비트 및 64비트 변형과 같은 사용 가능한 옵션 조합을 선택합니다.Choose any combination of the available options, such as 32-bit and 64-bit variants of the Python 2, Python 3, Miniconda, Anaconda2, and Anaconda3 distributions that you plan to work with. 각각은 배포의 인터프리터, 런타임 및 라이브러리를 포함합니다.Each includes the distribution's interpreter, runtime, and libraries. 특히 Anaconda는 다양한 미리 설치된 패키지를 포함하는 개방형 데이터 과학 플랫폼입니다.Anaconda, specifically, is an open data science platform that includes a wide range of pre-installed packages. (배포를 추가하거나 제거하기 위해 언제든지 Visual Studio 설치 관리자로 돌아갈 수 있습니다.) 참고: Visual Studio 설치 관리자 외부에서 배포를 설치한 경우 여기서 해당 옵션을 선택할 필요가 없습니다.(You can return to the Visual Studio installer at any time to add or remove distributions.) Note: If you've installed a distribution outside of the Visual Studio installer, there's no need to check the equivalent option here. Visual Studio에서 기존 Python 설치를 자동으로 검색합니다.Visual Studio automatically detects existing Python installations. Python 환경 창을 참조하세요.See The Python Environments window. 또한 설치 관리자에 표시된 버전보다 최신 버전의 Python을 사용할 수 있는 경우 해당 버전을 별도로 설치할 수 있으며, Visual Studio에서 이를 검색합니다.Also, if a newer version of Python is available than what's shown in the installer, you can install that version separately and Visual Studio will detect it.
    Cookiecutter 템플릿 지원Cookiecutter template support Cookiecutter 그래픽 UI를 설치하여 템플릿을 검색하고, 템플릿 옵션을 입력하고, 프로젝트 및 파일을 만듭니다.Installs the Cookiecutter graphical UI to discover templates, input template options, and create projects and files. Cookiecutter 확장 사용을 참조하세요.See Use the Cookiecutter extension.
    Python 웹 지원Python web support Bottle, Flask 및 Django 프레임워크를 사용하는 프로젝트에 대한 템플릿과 함께 HTML, CSS 및 JavaScript 편집 지원을 포함하는 웹 개발용 도구를 설치합니다.Installs tools for web development including HTML, CSS, and JavaScript editing support, along with templates for projects using the Bottle, Flask, and Django frameworks. Python 웹 프로젝트 템플릿을 참조하세요.See Python web project templates.
    Python 네이티브 개발 도구Python native development tools C++ 컴파일러 및 Python에 대한 기본 확장을 개발하는 데 필요한 기타 구성 요소를 설치합니다.Installs the C++ compiler and other necessary components to develop native extensions for Python. Python용 C++ 확장 만들기를 참조하세요.See Create a C++ extension for Python. 또한 전체 C++ 지원을 사용하려면 C++를 사용한 데스크톱 개발 워크로드를 설치하세요.Also install the Desktop development with C++ workload for full C++ support.
    Azure Cloud Services 핵심 도구Azure Cloud Services core tools Python에서 개발자 Azure Cloud Services에 대한 추가 지원을 제공합니다.Provides additional support for developer Azure Cloud Services in Python. Azure Cloud Service 프로젝트를 참조하세요.See Azure cloud service projects.
  4. 설치가 끝나면 설치 관리자는 Visual Studio를 수정, 실행, 복구 또는 제거하는 옵션을 제공합니다.After installation, the installer provides options to modify, launch, repair, or uninstall Visual Studio. 수정 단추는 설치된 구성 요소의 Visual Studio에 대한 업데이트를 사용할 수 있으면 업데이트로 변경됩니다.The Modify button changes to Update when updates to Visual Studio are available for any installed components. (수정 옵션은 드롭다운 메뉴에서 사용할 수 있습니다.) "Visual Studio"를 검색하여 Windows 시작 메뉴에서 Visual Studio 및 설치 관리자를 시작할 수도 있습니다.(The Modify option is then available on the drop-down menu.) You can also launch Visual Studio and the installer from the Windows Start menu by searching on "Visual Studio".

    설치 관리자에서 Visual Studio 시작, 수정 또는 제거

문제 해결Troubleshooting

Visual Studio에서 Python 설치 또는 실행 문제가 발생하는 경우 다음을 시도합니다.If you encounter problems installing or running Python in Visual Studio, try the following:

  • Python CLI를 사용하여 동일한 오류가 발생했는지 확인합니다. 즉, 명령 프롬프트에서 python.exe를 실행합니다.Determine whether the same error occurs using the Python CLI, that is, running python.exe from a command prompt.
  • Visual Studio 설치 관리자의 복구 옵션을 사용합니다.Use the Repair option in the Visual Studio installer.
  • Windows의 설정 > 앱 및 기능을 통해 Python을 복구하거나 다시 설치합니다.Repair or reinstall Python through Settings > Apps & features in Windows.

오류 예제: 대화형 프로세스를 시작하지 못했습니다. System.ComponentModel.Win32Exception (0x80004005): Microsoft.PythonTools.Repl.PythonInteractiveEvaluator.d__43.MoveNext()에서 알 수 없는 오류(0xc0000135)입니다.Example error: Failed to start interactive process: System.ComponentModel.Win32Exception (0x80004005): Unknown error (0xc0000135) at Microsoft.PythonTools.Repl.PythonInteractiveEvaluator.d__43.MoveNext().

Visual Studio 2015Visual Studio 2015

  1. 제어판 > 프로그램 및 기능에서 Microsoft Visual Studio 2015, 변경을 차례로 선택하여 Visual Studio 설치 관리자를 실행합니다.Run the Visual Studio installer through Control Panel > Programs and Features, selecting Microsoft Visual Studio 2015 and then Change.

  2. 설치 관리자에서 수정을 선택합니다.In the installer, select Modify.

  3. 프로그래밍 언어 > Visual Studio용 Python 도구를 선택하고 다음을 선택합니다.Select Programming Languages > Python Tools for Visual Studio and then Next:

    Visual Studio 2015 설치 관리자의 PTVS 옵션

  4. Visual Studio 설치가 완료되면 원하는 Python 인터프리터를 설치합니다.Once Visual Studio setup is complete, install a Python interpreter of your choice. Visual Studio 2015는 Python 3.5 이하만 지원합니다. 이후 버전에서는 지원되지 않는 Python 버전 3.6과 같은 메시지를 생성합니다.Visual Studio 2015 supports only Python 3.5 and earlier; later versions generate a message like Unsupported Python version 3.6). 이미 인터프리터가 설치되어 있고 Visual Studio에서 이를 자동으로 검색하지 않는 경우 기존 환경 수동 식별을 참조하세요.If you already have an interpreter installed and Visual Studio doesn't detect it automatically, see Manually identify an existing environment.

Visual Studio 2013 및 이전 버전Visual Studio 2013 and earlier

  1. 사용 중인 Visual Studio 버전에 맞는 적절한 버전의 Visual Studio용 Python 도구를 설치합니다.Install the appropriate version of Python Tools for Visual Studio for your version of Visual Studio:

  2. 원하는 Python 인터프리터를 설치합니다.Install a Python interpreter of your choice. 이미 인터프리터가 설치되어 있고 Visual Studio에서 이를 자동으로 검색하지 않는 경우 기존 환경 수동 식별을 참조하세요.If you already have an interpreter installed and Visual Studio doesn't detect it automatically, see Manually identify an existing environment.

설치 위치Install locations

기본적으로 Python 지원은 컴퓨터의 모든 사용자를 위해 설치됩니다.By default, Python support is installed for all users on a computer.

Visual Studio 2019 및 Visual Studio 2017에서 Python 워크로드는 %ProgramFiles(x86)%\Microsoft Visual Studio\<VS_version>\<VS_edition>Common7\IDE\Extensions\Microsoft\Python에 설치됩니다. 여기서 <VS_version>은 2019 또는 2017이고 <VS_edition>은 Community, Professional 또는 Enterprise입니다.For Visual Studio 2019 and Visual Studio 2017, the Python workload is installed in %ProgramFiles(x86)%\Microsoft Visual Studio\<VS_version>\<VS_edition>Common7\IDE\Extensions\Microsoft\Python where <VS_version> is 2019 or 2017 and <VS_edition> is Community, Professional, or Enterprise.

Visual Studio 2015 및 이전 버전에서 설치 경로는 다음과 같습니다.For Visual Studio 2015 and earlier, installation paths are as follows:

  • 32비트:32-bit:
    • 경로: %Program Files(x86)%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>Path: %Program Files(x86)%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>
    • 경로의 레지스트리 위치: HKEY_LOCAL_MACHINE\Software\Microsoft\PythonTools\<VS_ver>\InstallDirRegistry location of path: HKEY_LOCAL_MACHINE\Software\Microsoft\PythonTools\<VS_ver>\InstallDir
  • 64비트:64-bit:
    • 경로: %Program Files%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>Path: %Program Files%\Microsoft Visual Studio <VS_ver>\Common7\IDE\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver>
    • 경로의 레지스트리 위치: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\PythonTools\<VS_ver>\InstallDirRegistry location of path: HKEY_LOCAL_MACHINE\Software\Wow6432Node\Microsoft\PythonTools\<VS_ver>\InstallDir

다음은 각 문자에 대한 설명입니다.where:

  • <VS_ver>는 다음과 같습니다.<VS_ver> is:
    • Visual Studio 2015의 경우 14.014.0 for Visual Studio 2015
    • Visual Studio 2013의 경우 12.012.0 for Visual Studio 2013
    • Visual Studio 2012의 경우 11.011.0 for Visual Studio 2012
    • Visual Studio 2010의 경우 10.010.0 for Visual Studio 2010
  • <PTVS_ver>는 2.2.2, 2.1.1, 2.0, 1.5, 1.1, 1.0과 같은 버전 번호입니다.<PTVS_ver> is a version number, such as 2.2.2, 2.1.1, 2.0, 1.5, 1.1, or 1.0.

사용자 고유의 설치(1.5 및 이전 버전)User-specific installations (1.5 and earlier)

Visual Studio용 Python 도구 1.5 이하에서는 현재 사용자에 대한 설치만 허용했습니다. 이 경우 설치 경로는 %LocalAppData%\Microsoft\VisualStudio\<VS_ver>\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver> 이고, 여기서 <VS_ver> 및 <PTVS_ver>는 위에 설명된 것과 같습니다.Python Tools for Visual Studio 1.5 and earlier allowed installation for the current user only, in which case the installation path is %LocalAppData%\Microsoft\VisualStudio\<VS_ver>\Extensions\Microsoft\Python Tools for Visual Studio\<PTVS_ver> where <VS_ver> and <PTVS_ver> are the same as described above.