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

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

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

필수 조건

• Visual Studio. 제품을 설치하려면 Visual Studio 설치의 단계를 따릅니다.

• 기존 환경 간에만 전환할 수 있습니다. 기본 전역 환경 이외의 환경이 없는 경우 가상 환경 작업에 대한 다음 섹션을 참조하세요. 자세한 내용은 Visual Studio에서 Python 환경 만들기 및 관리를 참조하세요.

현재 프로젝트 환경 전환

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

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

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

   

2. 환경 추가 대화 상자에서 기존 환경 탭을 선택합니다. 환경 드롭다운 목록을 확장하고 원하는 환경을 선택한 다음 추가를 선택합니다.

   

참고 항목

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

가상 환경 사용

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

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

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

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

가상 환경 만들기

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

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

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

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

   

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

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

4. 원하는 선택적 필드를 구성합니다.

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

5. 가상 환경을 완료하려면 만들기를 선택합니다.

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

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

환경 활성화

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

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

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

   

   Visual Studio가 해당 환경에서 requirements.txt 파일을 검색하는 경우 이러한 패키지를 설치할지 묻는 메시지가 표시됩니다.

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

   

가상 환경 제거

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

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

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

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

설치된 패키지 보기 및 관리

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

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

  

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

  

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

  

  Visual Studio에서 대부분의 환경에 대한 패키지 및 종속성은 사용 가능한 패키지를 검색할 수도 있는 PyPI(Python 패키지 인덱스)에서 다운로드됩니다. 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 패키지 관리자도 사용할 수 있습니다. 명령줄의 명령이나 easy_install 명령을 사용하여 pip 설치한 패키지도 표시됩니다.

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

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

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

관련 콘텐츠

• Visual Studio에서 Python 환경 관리
• 종속성에 대해 requirements.txt 사용
• 검색 경로
• Python 환경 창 참조