다음을 통해 공유

Visual Studio에서 Python 환경을 만들고 관리

  • 아티클

Python 환경은 Python 코드를 실행할 컨텍스트이며 전역, 가상 및 conda 환경을 포함합니다. 환경은 인터프리터, 라이브러리(일반적으로 Python 표준 라이브러리) 및 설치된 패키지 집합으로 구성됩니다. 이러한 모든 구성 요소에 따라 유효한 언어 구성과 구문, 액세스할 수 있는 운영 체제 기능 그리고 사용할 수 있는 패키지가 결정됩니다.

Windows의 Visual Studio에서는 이 문서에 설명된 대로 Python 환경 창을 사용하여 여러 환경을 관리하고 새 프로젝트의 기본값으로 하나의 환경을 선택합니다. 환경의 기타 측면은 다음 문서를 참조하십시오.

  • 지정된 프로젝트의 경우 기본값을 사용하는 대신 특정 환경을 선택할 수 있습니다.

  • Python 프로젝트용 가상 환경을 만들고 사용하는 방법에 대한 자세한 내용은 가상 환경 사용을 참조하세요.

  • 환경에 패키지를 설치하려는 경우 패키지 탭 참조를 참조합니다.

  • 다른 Python 인터프리터를 설치하려면 Python 인터프리터 설치를 참조하세요. 일반적으로 기본 Python 배포를 위해 설치 관리자를 다운로드하고 실행하는 경우 Visual Studio는 새로 설치 및 환경이 Python 환경 창에 표시되고 프로젝트에 대해 선택될 수 있음을 검색합니다.

참고 항목

파일>열기>폴더를 선택하여 폴더로 열리는 Python 코드의 환경을 관리할 수 있습니다. Python 툴바를 사용하면 검색된 모든 환경 간에 전환하고 새 환경을 추가할 수도 있습니다. 환경 정보는 Workspace PythonSettings.json 폴더의 .vs 파일에 저장됩니다.

필수 조건

  • Python 워크로드가 설치되어 있어야 합니다.

Visual Studio에서 Python을 처음 사용하는 경우 일반적인 배경 정보는 다음 문서를 참조하세요.

Python 환경 창

Visual Studio에서 인식하는 환경이 Python 환경 창에 표시됩니다. 창을 열려면 다음 방법 중 하나를 사용합니다.

  • 보기>다른 창>Python 환경을 선택합니다.
  • 솔루션 탐색기에서 프로젝트의 Python 환경 노드를 마우스 오른쪽 단추로 클릭하고 모든 Python 환경 보기를 선택합니다.

Visual Studio 2019용 솔루션 탐색기 모든 Python 환경 보기 명령 스크린샷

Visual Studio 2022용 솔루션 탐색기 모든 Python 환경 보기 명령 스크린샷

Python 환경 창은 Visual Studio의 솔루션 탐색기와 함께 나타납니다.

Visual Studio 2019의 Python 환경 창 스크린샷

Visual Studio 2022의 Python 환경 창 스크린샷

Visual Studio는 레지스트리(다음 PEP 514)와 함께 가상 환경 및 Conda 환경(환경 유형 참조)을 사용하여 설치된 글로벌 환경을 검색합니다. 목록에 원하는 환경이 표시되지 않으면 기존 환경 수동 식별을 참조하세요.

목록에서 환경을 선택하면 Visual Studio는 Python 환경 창의 개요 탭에 해당 환경에 대한 다양한 속성과 명령(예: 인터프리터 위치)을 표시합니다. 개요 탭 아래에 있는 명령은 각각 인터프리터가 실행 중인 명령 프롬프트를 엽니다. 자세한 내용은 Python 환경 창 탭 참조 - 개요를 참조하세요.

환경 목록 아래의 드롭다운 목록을 사용하여 패키지, IntelliSense 등의 다른 탭으로 전환합니다. 이러한 탭은 Python 환경 창 탭 참조에도 설명되어 있습니다.

환경을 선택해도 모든 프로젝트에 대한 해당 관계는 변경되지 않습니다. 목록에서 굵게 표시된 기본 환경은 Visual Studio가 모든 새 프로젝트에 대해 사용하는 환경입니다. 새 프로젝트에서 다른 환경을 사용하려면 이 환경을 새 프로젝트의 기본 환경으로 설정 명령을 사용합니다. 프로젝트의 컨텍스트 내에서 항상 특정한 환경을 선택할 수 있습니다. 자세한 내용은 프로젝트의 환경 선택을 참조하세요.

나열된 각 환경의 오른쪽에는 해당 환경에 대한 대화형 창을 여는 컨트롤이 있습니다. (Visual Studio 2017 15.5 및 이전 버전에서는 해당 환경에 대한 IntelliSense 데이터베이스를 새로 고치는 다른 컨트롤이 나타납니다. 데이터베이스에 대한 자세한 내용은 Python 환경 창 탭 참조를 확인하세요.)

팁

Python 환경 창을 충분히 넓게 확장하면 작업하기에 더 편리한 환경을 보다 자세히 볼 수 있습니다.

Visual Studio 2019의 환경 창 확장된 보기 스크린샷

팁

Python 환경 창을 충분히 넓게 확장하면 작업하기에 더 편리한 환경을 보다 자세히 볼 수 있습니다.

Visual Studio 2022의 Python 환경 창 확장된 보기 스크린샷

참고 항목

Visual Studio에서는 system-site-packages 옵션을 적용하지만 Visual Studio 내에 이를 변경하는 방법은 제공하지 않습니다.

환경이 나타나지 않으면 어떻게 하나요?

Python 환경 창에 환경이 표시되지 않으면 Visual Studio가 표준 위치에서 Python 설치를 검색하지 못한 것입니다. Visual Studio 2017 이상을 설치했지만 Python 워크로드에 대한 설치 관리자 옵션에서 모든 인터프리터 옵션을 선택 취소했을 수 있습니다. 마찬가지로 Visual Studio 2015 또는 이전 버전을 설치했지만 인터프리터를 수동으로 설치하지 않았을 수 있습니다. 자세한 내용은 Python 인터프리터 설치를 참조하세요.

컴퓨터에 Python 인터프리터가 있지만 Visual Studio(모든 버전)가 이를 검색하지 못한 경우 + 사용자 지정 명령을 사용하여 인터프리터 위치를 수동으로 지정합니다. 자세한 내용은 기존 환경을 수동으로 식별하는 방법을 참조하세요.

환경 유형

Visual Studio는 글로벌 환경, 가상 환경 및 Conda 환경을 사용할 수 있습니다.

글로벌 환경

각 Python 설치는 자체 글로벌 환경을 유지 관리합니다. 예를 들어 Python 2.7, Python 3.6, Python 3.7, Anaconda 4.4.0 등이 있습니다. 자세한 내용은 Python 인터프리터 설치를 참조하세요.

각 환경은 특정 Python 인터프리터, 표준 라이브러리 및 사전 설치된 패키지 집합으로 구성됩니다. 또한 환경이 활성화되는 동안 설치하는 다른 패키지도 포함됩니다. 패키지를 전역 환경에 설치하면 해당 환경을 사용하는 모든 프로젝트에서 사용할 수 있습니다. 환경이 파일 시스템의 보호 영역(예: c:\program files 내)에 있는 경우 패키지를 설치하려면 관리자 권한이 필요합니다.

전역 환경은 컴퓨터의 모든 프로젝트에서 사용할 수 있습니다. Visual Studio에서는 특별히 프로젝트별로 다른 항목을 선택하지 않는 한 하나의 전역 환경을 모든 프로젝트에 사용되는 기본값으로 선택합니다. 자세한 내용은 프로젝트의 환경 선택을 참조하세요.

가상 환경

글로벌 환경에서 작업하는 것은 쉽게 시작할 수 있는 방법입니다. 시간이 지남에 따라 환경은 다양한 프로젝트에 대해 설치한 다양한 패키지로 복잡해집니다. 이러한 문제가 있기 때문에 알려진 버전의 특정 패키지 세트에 대해 응용 프로그램을 철저히 테스트하기가 어렵습니다. 그러나 이러한 종류의 환경은 빌드 서버나 웹 서버에서 설정할 것으로 예상되는 환경입니다. 두 프로젝트에 호환되지 않는 패키지 또는 동일한 패키지의 다른 버전이 필요한 경우 충돌이 발생할 수 있습니다.

이러한 이유로 개발자는 종종 프로젝트에 대한 가상 환경을 만듭니다. 가상 환경은 특정 인터프리터가 포함된 프로젝트의 하위 폴더입니다. 가상 환경이 활성화되면 설치한 모든 패키지는 해당 환경의 하위 폴더에만 설치됩니다. Python 프로그램을 가상 환경 내에서 실행하면 해당 프로그램을 특정 패키지에 대해서만 실행하고 있다는 것을 확신할 수 있습니다.

Visual Studio는 프로젝트에 대한 가상 환경을 만드는 작업을 직접 지원합니다. requirements.txt 파일이 포함된 프로젝트를 열면 Visual Studio에서 가상 환경을 만들고 해당 종속성을 설치하라는 메시지를 자동으로 표시합니다. requirements.txt 파일을 포함하는 템플릿에서 프로젝트를 만들 때도 동일한 동작이 표시됩니다.

열린 프로젝트 내에서 언제든 새 가상 환경을 만들 수 있습니다. 솔루션 탐색기에서 프로젝트 노드를 확장하고 Python 환경 노드를 마우스 오른쪽 단추로 클릭하며 환경 추가를 선택합니다. 환경 추가에서 가상 환경을 선택합니다. 자세한 내용은 가상 환경 만들기를 참조하세요.

또한 Visual Studio에서는 쉽게 다른 컴퓨터에서 환경을 다시 만들 수 있도록 가상 환경에서 requirements.txt 파일을 생성하는 명령을 제공합니다. 자세한 내용은 가상 환경 사용을 참조하세요.

Conda 환경

conda 도구를 사용하거나 Visual Studio 2017 버전 15.7 및 이후 버전에서 통합 Conda 관리를 사용하여 Conda 환경을 만들 수 있습니다. Conda 환경에는 Anaconda 또는 Miniconda가 필요합니다. 이러한 플랫폼은 Visual Studio 설치 관리자 통해 사용할 수 있습니다. 자세한 내용은 Visual Studio에서 Python 지원 설치를 참조하세요.

  1. Python 환경 창(또는 Python 도구 모음)에서 환경 추가를 선택하여 환경 추가 대화 상자를 엽니다.

  2. 환경 추가 대화 상자에서 Conda 환경 탭을 선택합니다.

    Visual Studio 환경 추가 대화 상자의 Conda 환경 탭 스크린샷

  3. 다음 필드를 구성하세요.

    필드 설명
    프로젝트 환경을 만들 프로젝트를 식별합니다.
    이름 Conda 환경의 이름을 제공합니다.
    다음의 패키지 추가 Conda 환경에 패키지를 추가하는 방법을 지정합니다.
    - 환경 파일: 종속성을 설명하는 environment.yml 파일이 있는 경우 이 옵션을 선택합니다. 파일 이름을 입력하거나 파일 위치를 찾아서(...) 파일을 선택합니다.
    - 하나 이상의 Anaconda 패키지 이름: 하나 이상의 Python 패키지 또는 Python 버전을 나열하려면 이 옵션을 선택합니다.

    패키지 목록은 Conda에 Python 환경을 만들도록 지시합니다. 최신 버전의 Python을 설치하려면 python 명령을 사용합니다. 특정 버전을 설치하려면 python=,major>.<minor>에서와 같이 python=3.7 명령을 사용합니다. 패키지 단추를 사용하여 일련의 메뉴에서 Python 버전 및 공통 패키지를 선택할 수도 있습니다.
    현재 환경으로 설정 환경이 만들어지면 선택한 프로젝트에서 새 환경을 활성화합니다.
    새 프로젝트의 기본 환경으로 설정 Visual Studio에서 만드는 모든 새 프로젝트에서 자동으로 Conda 환경을 설정하고 활성화합니다. 이 옵션은 Python 환경 창에서 이 환경을 새 프로젝트의 기본 환경으로 설정을 사용하는 것과 동일합니다.
    Python 환경 창에서 보기 환경을 만든 후 Python 환경 창을 표시할 것인지 지정합니다.

    Important

    Conda 환경을 만들 때 환경에 Python 런타임이 포함되도록 Python 버전 또는 Python 패키지를 하나 이상 지정해야 합니다. environments.yml 파일 또는 패키지 목록을 사용할 수 있습니다. 이 사양을 제공하지 않으면 Visual Studio는 환경을 무시합니다. 환경은 Python 환경 창 어디에도 표시되지 않고, 프로젝트의 현재 환경으로 설정되지 않으며, 글로벌 환경으로 사용할 수 없습니다.

    Python 버전 없이 Conda 환경을 만드는 경우 conda info 명령을 사용하여 Conda 환경 폴더의 위치를 확인합니다. 그런 다음 해당 위치에서 환경의 하위 폴더를 수동으로 제거할 수 있습니다.

  4. 만들기를 실행합니다.

    출력 창에서 Conda 환경 생성을 모니터링할 수 있습니다. 만들기가 완료되면 출력에 activate env와 같은 일부 CLI(명령줄 인터페이스) 명령이 표시됩니다.

    Visual Studio에서 Conda 환경을 성공적으로 만드는 방법을 보여 주는 스크린샷

  5. Visual Studio에서 다른 환경과 동일한 방식으로 프로젝트에 대한 Conda 환경을 활성화할 수 있습니다. 자세한 내용은 프로젝트의 환경 선택을 참조하세요.

  6. 환경에서 패키지를 더 설치하려면 Python 환경 창의 패키지 탭을 사용합니다.

참고 항목

Conda 환경에서 최상의 결과를 얻으려면 Conda 4.4.8 이상을 사용합니다. Conda 버전은 Anaconda 버전과 다릅니다. Visual Studio 설치 관리자를 통해 적합한 버전의 Miniconda(Visual Studio 2019 및 Visual Studio 2022)와 Anaconda(Visual Studio 2017)를 설치할 수 있습니다.

Conda 환경이 저장된 Conda 버전 및 기타 정보를 보려면 Anaconda 명령 프롬프트(즉, Anaconda가 경로에 있는 명령 프롬프트)에서 conda info 명령을 실행합니다.

conda info

Conda 환경 폴더가 다음과 같이 표시됩니다.

       envs directories : C:\Users\user\.conda\envs
                          c:\anaconda3\envs
                          C:\Users\user\AppData\Local\conda\conda\envs

Conda 환경은 프로젝트와 함께 저장하지 않았기 때문에 글로벌 환경에서 비슷하게 작동합니다. 예를 들어 새 패키지를 Conda 환경에 설치하면 해당 환경을 사용하는 모든 프로젝트에서 해당 패키지를 사용할 수 있습니다.

Visual Studio 2017 버전 15.6 이전의 경우 기존 환경 수동 식별에 설명된 대로 수동으로 지정하여 Conda 환경을 사용할 수 있습니다.

Visual Studio 2017 버전 15.7 이상에서는 Conda 환경을 자동으로 검색하고 다음 섹션에 설명된 대로 Python 환경 창을 표시합니다.

기존 환경 수동 식별

비표준 위치에 설치된 환경을 식별하려면 다음 단계를 수행합니다.

  1. Python 환경 창(또는 Python 도구 모음)에서 환경 추가를 선택하여 환경 추가 대화 상자를 엽니다.

  2. 환경 추가 대화 상자의 기존 환경 탭에서 환경 필드를 다음과 같이 <사용자 지정>으로 설정합니다.

    환경 필드를 사용자 지정으로 설정하는 방법을 보여 주는 Visual Studio의 환경 추가 대화 상자 기존 환경 탭 스크린샷

    <사용자 지정> 값을 선택하면 대화 상자에 더 많은 필드가 추가됩니다.

  3. 접두사 경로 필드를 인터프리터의 경로로 설정합니다. 경로 위치를 탐색(...)하여 필드를 설정할 수 있습니다.

    Visual Studio의 환경 추가 대화 상자에서 사용자 지정 환경의 세부 정보를 지정하는 방법을 보여 주는 스크린샷

  4. 경로를 선택하면 나머지 필드가 채워집니다. 값을 검토하고 필요에 따라 수정합니다. 준비가 되면 추가를 선택합니다.

Python 환경 창에서 언제든지 환경의 세부 정보를 검토하고 수정할 수도 있습니다.

  1. Python 환경 창에서 환경을 선택하고 구성 탭을 선택합니다.

  2. 내용을 변경한 후에는 적용 명령을 선택합니다.

제거 명령을 사용하여 환경을 제거할 수도 있습니다. 자세한 내용은 구성 탭을 참조하세요. 자동 검색된 환경에서는 이 명령을 사용할 수 없습니다.

잘못된 환경 수정 또는 삭제

Visual Studio에서 환경에 대한 레지스트리 항목을 찾았지만 인터프리터에 대한 경로가 올바르지 않은 경우 다음 이미지와 같이 Python 환경 창은 취소선 글꼴을 사용하여 환경 이름을 표시합니다.

Visual Studio의 잘못된 환경을 보여 주는 Python 환경 창의 스크린샷

유지할 환경을 수정하려면 먼저 해당 환경 설치 관리자의 복구 프로세스를 사용해 보세요. 대부분의 설치 관리자에는 복구 옵션이 포함되어 있습니다.

환경을 수정하도록 레지스트리 수정

복구 옵션이 포함되지 않은 Python 환경을 수정하거나 잘못된 환경을 제거하려면 다음 단계를 사용하여 레지스트리를 직접 수정할 수 있습니다. 레지스트리를 변경하는 경우, Visual Studio는 Python 환경 창을 자동으로 업데이트합니다.

  1. regedit.exe 실행 파일을 실행하여 레지스트리 편집기를 엽니다.

  2. 구성에 해당하는 환경 폴더로 이동합니다.

    Python 버전 폴더
    64비트 버전 HKEY_LOCAL_MACHINE\SOFTWARE\Python 또는 HKEY_CURRENT_USER\Software\Python
    32비트 버전 HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python
    IronPython IronPython

  3. 환경의 배포 및 버전 노드 구조를 확장합니다.

    배포 노드
    CPython PythonCore><버전 노드>
    Anaconda ContinuumAnalytics><버전 노드>
    IronPython <버전 노드>

  4. InstallPath 노드 아래의 값을 검사합니다.

    레지스트리 편집기의 일반적인 CPython 설치에 대한 레지스트리 항목 스크린샷

    • 컴퓨터에 여전히 환경이 있는 경우 ExecutablePath 항목의 값을 현재 위치로 변경합니다. 필요에 따라 (기본값) 및 WindowedExecutablePath 항목 값을 수정합니다.
    • 환경이 컴퓨터에 더 이상 존재하지 않고 Python 환경 창에서 제거하려는 경우 InstallPath 노드의 버전 번호 부모 노드를 삭제합니다. 이전 이미지에서 이 노드의 예를 볼 수 있습니다. 이 예에서 이 노드는 3.6입니다.

    주의

    HKEY_CURRENT_USER\SOFTWARE\Python 키의 잘못된 설정은 HKEY_LOCAL_MACHINE\SOFTWARE\Python 키의 설정을 재정의합니다.

Python 환경 삭제 또는 제거

Python 프로젝트를 제거하려면 솔루션 탐색기 창에서 Python 환경으로 이동합니다. 제거하려는 Python 환경을 마우스 오른쪽 단추로 클릭하고 제거를 선택합니다.

Visual Studio에서 Python 환경을 제거하는 방법을 보여 주는 스크린샷

Python 환경을 유지하지만 프로젝트에서 제거하려면 제거를 선택합니다. 환경을 영구적으로 삭제하려면 삭제를 선택합니다.

Visual Studio에서 Python 환경을 삭제하거나 제거하는 방법을 보여 주는 스크린샷

관련 콘텐츠