Visual Studio 프로젝트에 대한 Python 환경 선택

Python 프로젝트의 모든 코드는 특정 환경의 컨텍스트 내에서 실행됩니다. 이러한 환경은 전역 Python 환경, Anaconda 환경, 가상 환경 또는 conda 환경일 수 있습니다. Visual Studio 디버깅, 가져오기 및 멤버 완성 및 구문 검사에 Python 환경을 사용합니다. 환경은 Python 버전 및 설치된 패키지 집합과 관련된 언어 서비스가 필요한 모든 작업에 사용됩니다.

Visual Studio 프로젝트에 대한 여러 환경을 만들고 특정 개발 요구 사항에 따라 전환할 수 있습니다. 모든 새 Python 프로젝트는 처음에 기본 전역 환경을 사용하도록 구성됩니다. Python Environments 노드(솔루션 탐색기에서 프로젝트의 환경을 볼 수 있습니다.

프로젝트의 Visual Studio 솔루션 탐색기에 대한 전역 기본 Python 환경을 보여주는 스크린샷입니다.

사전 요구 사항

현재 프로젝트 환경 전환

Visual Studio 솔루션 탐색기 또는 Add Environment 기능을 사용하여 도구 모음에서 Python 프로젝트의 활성(현재) 환경을 변경할 수 있습니다.

  1. 환경 추가 프로세스를 시작합니다.

    • 솔루션 탐색기 프로젝트의 Python Environments 노드를 마우스 오른쪽 단추로 클릭하고 Add Environment 선택합니다.
    • Python 도구 모음에서 환경 드롭다운 메뉴에서 환경 추가를 선택합니다.
  2. 환경 추가 대화 상자에서 기존 환경 탭을 선택합니다. 환경 드롭다운 목록을 확장하고 원하는 환경을 선택한 다음 추가를 선택합니다.

    Visual Studio의 환경 추가 대화 상자에서 프로젝트 환경을 선택하는 방법을 보여주는 스크린샷입니다.

메모

사용하려는 환경이 나열되지 않은 경우 기존 환경을 수동으로 식별해야 할 수 있습니다.

가상 환경 사용

가상 환경은 특정 Python 인터프리터와 다른 전역 및 conda 환경과 다른 특정 라이브러리 집합의 고유한 조합입니다. 가상 환경은 프로젝트와 관련이 있으며 프로젝트 하위 폴더에서 유지 관리됩니다. 이 폴더에는 환경의 설치된 라이브러리와 파일 시스템에서 환경의 기본 인터프리터 경로를 지정하는 pyvenv.cfg 파일이 포함되어 있습니다. (가상 환경에는 인터프리터의 복사본이 없고 해당 인터프리터에 대한 링크만 포함됩니다.)

가상 환경을 사용하는 한 가지 이점은 시간이 지남에 따라 프로젝트를 개발할 때 가상 환경이 항상 프로젝트의 정확한 종속성을 반영한다는 것입니다. 이 동작은 프로젝트에서 사용할지 여부에 관계없이 많은 수의 라이브러리를 포함하는 공유 전역 환경과 다릅니다. 가상 환경에서 다른 개발 또는 프로덕션 컴퓨터에 패키지 종속성을 다시 설치하는 데 사용되는 requirements.txt 파일을 쉽게 만들 수 있습니다. 자세한 내용은 requirements.txt사용하여 필요한 패키지 관리를 참조하세요.

requirements.txt 파일이 포함된 Visual Studio 프로젝트를 열면 Visual Studio 가상 환경을 다시 만들 수 있는 옵션이 자동으로 제공됩니다. Visual Studio 설치되지 않은 컴퓨터에서는 pip install -r requirements.txt 명령을 사용하여 필요한 패키지를 복원할 수 있습니다.

가상 환경에는 기본 Python 인터프리터에 대한 하드 코딩된 경로가 포함되어 있으며 requirements.txt 파일을 사용하여 환경을 다시 만들 수 있으므로 일반적으로 소스 제어에서 환경 하위 폴더를 생략합니다. 프로젝트에 가상 환경을 추가하면 Python 환경 창에 표시됩니다. 그런 다음 다른 환경처럼 활성화하고 해당 패키지를 관리할 수 있습니다.

가상 환경 만들기

다음과 같이 Visual Studio 직접 새 가상 환경을 만들 수 있습니다.

  1. 환경 추가 프로세스를 시작합니다.

    • 솔루션 탐색기 프로젝트의 Python Environments 노드를 마우스 오른쪽 단추로 클릭하고 Add Environment 선택합니다.
    • 또는 Python 도구 모음의 환경 드롭다운 메뉴에서 환경 추가를 선택합니다.
  2. 환경 추가 대화 상자에서 가상 환경 탭을 선택합니다.

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

  3. 필요한 필드를 구성합니다.

    필수 필드 설명
    프로젝트 환경을 만들 프로젝트를 식별합니다.
    이름 새 가상 환경의 이름을 제공합니다.
    기본 인터프리터 가상 환경의 기본 언어 인터프리터를 지정합니다.
    Location 시스템은 가상 환경의 기본 위치를 할당합니다. 위치를 변경하려면 가상 환경 위치 변경 링크를 선택하고 위치를 찾아 폴더 선택을 선택합니다.
  4. 원하는 선택적 필드를 구성합니다.

    선택적 필드 설명
    파일에서 패키지 설치 가상 환경에 패키지를 추가할 requirements.txt 파일의 경로를 지정합니다. 파일의 위치와 이름을 입력하거나 위치로 이동(...)하고 파일을 선택합니다.
    현재 환경으로 설정 환경을 만든 후 선택한 프로젝트에서 새 환경을 활성화합니다.
    새 프로젝트의 기본 환경으로 설정 Visual Studio 만든 새 프로젝트에서 환경을 자동으로 설정하고 활성화합니다. 이 설정은 새 프로젝트에 대한 기본 환경으로 설정 옵션을 Python 환경 창에서도 사용할 수 있습니다. 이 옵션을 사용하면 가상 환경을 특정 프로젝트 외부의 위치에 배치합니다.
    Python 환경 창에서 보기 새 환경을 만든 후 Python 환경 창을 표시할지 여부를 지정합니다.
    이 환경을 전역적으로 사용할 수 있도록 설정 가상 환경이 전역 환경으로도 작동해야 하는지 여부를 지정합니다. 이 옵션을 사용하면 가상 환경을 특정 프로젝트 외부의 위치에 배치합니다.
  5. 만들기를 선택하여 가상 환경을 마무리합니다.

Visual Studio 환경을 구성하고 필요한 패키지를 다운로드하는 동안 진행률 표시줄을 표시합니다.

프로세스가 완료되면 Visual Studio 새 가상 환경을 활성화하고 솔루션 탐색기Python Environments 노드에 추가합니다. 환경은 포함하는 프로젝트의 Python 환경 창에서도 사용할 수 있습니다.

환경 활성화

프로젝트에 대한 기존 환경을 활성화하려면 다음 단계를 수행합니다.

  1. 솔루션 탐색기 프로젝트의 Python 환경 노드를 확장하고 사용하려는 환경을 찾습니다.

  2. 환경을 마우스 오른쪽 단추로 클릭하고 환경 활성화를 선택합니다.

    Visual Studio 해당 환경에서 requirements.txt 파일을 검색하는 경우 해당 패키지를 설치할지 여부를 묻습니다.

    Visual Studio 환경을 활성화하면 활성 환경의 이름이 솔루션 탐색기 굵은 글꼴로 표시됩니다.

    솔루션 탐색기에서 활성 환경의 이름을 굵게 표시하는 방법을 보여주는 Visual Studio의 스크린샷입니다.

    Visual Studio의 활성 환경 이름이 솔루션 탐색기에서 굵은 글꼴로 표시되는 방법을 보여주는 스크린샷입니다.

가상 환경 제거

프로젝트에 대한 기존 환경을 제거하려면 다음 단계를 수행합니다.

  1. 솔루션 탐색기 가상 환경을 마우스 오른쪽 단추로 클릭하고 Remove 선택합니다.

  2. Visual Studio 가상 환경을 제거하거나 삭제할지 여부를 묻습니다.

    • 프로젝트를 사용할 수 없도록 하려면 [제거 ]를 선택하고 파일 시스템에 그대로 둡니다.
    • 삭제를 선택하여 프로젝트에서 환경을 제거하고 파일 시스템에서 삭제합니다. 기본 인터프리터는 영향을 받지 않습니다.

설치된 패키지 보기 및 관리

솔루션 탐색기 환경에 설치된 패키지를 보고 관리할 수 있습니다. 이러한 패키지는 환경이 활성 상태일 때 코드에서 가져오고 사용할 수 있습니다.

  • 환경에 설치된 패키지를 빠르게 보려면 솔루션 탐색기 프로젝트의 Python Environments 노드에서 환경 노드를 확장합니다.

    스크린샷은 Visual Studio의 솔루션 탐색기에서 환경에 대한 Python 패키지를 보여줍니다.

    Visual Studio의 솔루션 탐색기에서 환경에 대한 Python 패키지를 보여 주는 스크린샷.

  • 새 패키지를 설치하거나 기존 패키지를 관리하려면 환경 노드를 마우스 오른쪽 단추로 클릭하고 Python 패키지 관리 선택합니다. Python 도구 모음에서 패키지 단추를 사용할 수도 있습니다.

    Python 환경 창이 열리고 패키지(PyPI) 탭에 선택한 환경에 대해 설치된 패키지가 표시됩니다.

    Visual Studio 대부분의 환경에 대한 패키지 및 종속성은 Python PyPI(패키지 인덱스) 에서 다운로드되며, 여기서 사용 가능한 패키지를 검색할 수도 있습니다. Visual Studio 상태 표시줄 및 출력 창에는 설치에 대한 정보가 표시됩니다.

  • 패키지를 제거(제거)하려면 목록에서 패키지를 찾아 오른쪽에 있는 x 아이콘을 선택합니다.

  • 업데이트된 패키지 또는 다른 패키지 버전을 찾으려면 검색 용어(일반적으로 패키지 이름)를 입력합니다.

    Visual Studio 일치하는 패키지를 표시합니다. 이 예제에서는 깜박임이라는 용어와 일치하는 패키지를 검색 합니다.

    Visual Studio 일치하는 결과 목록을 활성 명령 링크로 표시합니다.

    • 첫 번째 명령은 패키지를 최신 버전 및 현재 종속성으로 새로 고칩니다. 이 명령은 . 명령과 Run command: pip install <package-name>비슷합니다. 검색어 뒤에 Enter를 선택하면 Visual Studio 이 첫 번째 명령을 자동으로 실행합니다.

    • 다른 링크는 특정 패키지, 버전 또는 종속성을 설치하는 명령(예: Install blinker-async (0.0.3). 이러한 명령 중 하나를 실행하려면 링크를 선택합니다.

패키지 설치에 대한 고려 사항

Visual Studio 패키지로 작업할 때는 다음 사항을 고려해야 합니다.

  • 패키지에 대해 표시된 항목이 최신 버전 또는 가용성 측면에서 정확하지 않을 수 있습니다. 패키지에 대해 표시된 설치 및 제거 정보가 신뢰할 수 없거나 사용할 수 없을 수 있습니다.

  • Visual Studio 사용 가능한 경우 pip 패키지 관리자를 사용하고 필요한 경우 다운로드하여 설치합니다. Visual Studio easy_install 패키지 관리자를 사용할 수도 있습니다. 명령줄에서 pip 또는 easy_install 명령어를 사용하여 설치한 패키지도 표시됩니다.

  • pip가 패키지를 설치하지 못하는 일반적인 상황은 패키지에 *.pyd 파일의 네이티브 구성 요소에 대한 소스 코드를 포함하는 경우입니다. 필요한 버전의 Visual Studio 설치되어 있지 않으면 pip는 이러한 구성 요소를 컴파일할 수 없습니다. 이 상황에 표시되는 오류 메시지는 오류입니다. vcvarsall.bat찾을 수 없습니다 . easy_install 명령은 미리 컴파일된 바이너리를 다운로드할 수 있으며 https://python.en.uptodown.com/windows/versions에서 이전 버전의 Python에 적합한 컴파일러를 다운로드할 수 있습니다. 자세한 내용은 Python 도구 팀 블로그에서 "vcvarsallbat를 찾을 수 없음"의 고통을 처리하는 방법을 참조하세요.

  • conda 패키지 관리자는 일반적으로 https://repo.continuum.io/pkgs/를 기본 채널로 사용하지만, 다른 채널도 사용할 수 있습니다. 자세한 내용은 채널 관리 (docs.conda.io)를 참조하세요.

  • Visual Studio 현재 conda 명령을 사용하여 conda 환경에 패키지를 설치하는 것을 지원하지 않습니다. conda 대신 명령줄에서 명령을 사용합니다.