빠른 시작: Visual Studio의 폴더에서 Python 코드 열기 및 실행

이 빠른 시작에서는 Visual Studio 프로젝트를 만들 필요 없이 Visual Studio 2019 이상에서 Python 코드를 실행하는 지침별 단계를 따릅니다. Visual Studio를 사용하면 폴더에서 기존 Python 코드를 쉽게 열고 실행할 수 있습니다. 프로젝트 작업을 선택할 때와 동일한 기능과 명령을 Python 코드 개발에 사용할 수 있습니다.

필수 조건

  • Python 워크로드에 대한 지원과 함께 설치된 Visual Studio. 자세한 내용은 Visual Studio에서 Python 지원 설치를 참조하세요.

  • 이 빠른 시작의 지침은 Python 코드가 있는 모든 폴더에 적용됩니다. 이 문서에 설명된 예제를 따르려면 다음 명령을 사용하여 컴퓨터에 gregmalcolm/python_koans GitHub 리포지토리를 복제합니다.

    git clone https://github.com/gregmalcolm/python_koans
    

Mac용 Visual Studio는 지원되지 않습니다. 자세한 내용은 Mac용 Visual Studio 무슨 일이 일어나고 있는지?를 참조하세요. Windows, Mac 및 Linux의 Visual Studio Code는 사용 가능한 확장을 통해 Python에서 잘 작동합니다.

로컬 코드 폴더 열기

Visual Studio에서 기존 Python 코드를 사용하여 로컬 폴더를 열려면 다음 단계를 수행합니다.

  1. Visual Studio를 시작합니다. 시작 창의 시작 열에서 로컬 폴더 열기를 선택합니다.

    Visual Studio 2022가 시작될 때 로컬 폴더 열기 옵션을 선택하는 방법을 보여 주는 스크린샷.

    Visual Studio가 시작될 때 로컬 폴더 열기 옵션을 선택하는 방법을 보여 주는 스크린샷.

    python_koans 리포지토리 예제 코드를 사용하는 경우 복제 폴더 내에서 python3 폴더를 선택해야 합니다.

    Visual Studio가 이미 실행되고 있으면 파일>폴더>폴더를 선택합니다.

  2. Python 코드가 포함된 폴더를 찾아 폴더 선택을 선택합니다.

    Visual Studio 2022에서 기존 Python 코드가 있는 로컬 폴더를 선택하는 방법을 보여 주는 스크린샷.

    Visual Studio에서 기존 Python 코드가 있는 로컬 폴더를 선택하는 방법을 보여 주는 스크린샷.

  3. Visual Studio는 폴더 보기에서 솔루션 탐색기의 파일을 표시합니다. 폴더 이름 왼쪽에 있는 화살표를 사용하여 폴더를 확장하거나 축소할 수 있습니다.

    Visual Studio 2022의 솔루션 탐색기 폴더에 대한 확장 및 축소 화살표를 보여 주는 스크린샷.

    Visual Studio의 솔루션 탐색기 폴더에 대한 확장 및 축소 화살표를 보여 주는 스크린샷.

  4. Python 폴더를 열면 Visual Studio는 프로그램과 관련된 설정을 관리하기 위해 여러 개의 숨겨진 폴더를 만듭니다. 이러한 폴더(및 .git 폴더와 같은 기타 숨겨진 파일 및 폴더)를 보려면 모든 파일 표시 도구 모음 옵션을 선택합니다.

    Visual Studio 2022의 솔루션 탐색기 숨겨진 폴더 및 파일을 보는 방법을 보여 주는 스크린샷.

    Visual Studio에서 솔루션 탐색기 숨겨진 폴더 및 파일을 보는 방법을 보여 주는 스크린샷.

프로그램 실행

Visual Studio에서 기존 Python 코드를 연 후 프로그램을 실행할 수 있습니다. 코드를 실행하려면 Visual Studio에서 프로그램을 실행하려면 시작 파일(시작 항목) 또는 기본 프로그램 파일을 식별해야 합니다. 본 예제에서 시작 파일은 contemplate-koans.py입니다.

  1. 솔루션 탐색기에서 contemplate-koans.py 파일을 마우스 오른쪽 단추로 클릭하고 시작 항목으로 설정을 선택합니다.

    Visual Studio 2022의 솔루션 탐색기에서 contemplate koans Python 파일을 시작 항목으로 설정하는 방법을 보여주는 스크린샷.

    Visual Studio의 솔루션 탐색기에서 contemplate koans Python 파일을 시작 항목으로 설정하는 방법을 보여 주는 스크린샷.

    Important

    시작 항목이 열려 있는 폴더의 루트에 없으면 작업 디렉터리 설정에 설명된 대로 시작 구성 JSON 파일에 줄도 추가해야 합니다.

  2. 코드를 실행하려면 디버그>디버깅하지 않고 시작 을 선택하거나 또는 키보드 바로 가기 단축키 Ctrl+F5를 사용하면 됩니다. Visual Studio 도구 모음에서 시작 항목 이름 옆에 있는 단색 재생 화살표를 선택할 수도 있습니다. 이 옵션은 Visual Studio 디버거에서 코드를 실행합니다.

    이러한 모든 시작 방법에 대해 Visual Studio는 시작 항목이 Python 파일임을 감지하고 자동으로 기본 Python 환경에서 코드를 실행합니다. 현재 환경은 도구 모음의 시작 항목 이름 오른쪽에 표시됩니다. 다음 예제에서 현재 환경은 Python 3.11(64비트)입니다.

    Visual Studio 2022 도구 모음에서 단색 재생 화살표를 사용하여 디버깅으로 프로그램을 시작하는 방법을 보여 주는 스크린샷.

    이러한 모든 시작 방법에 대해 Visual Studio는 시작 항목이 Python 파일임을 감지하고 자동으로 기본 Python 환경에서 코드를 실행합니다. 현재 환경은 도구 모음의 시작 항목 이름 오른쪽에 표시됩니다. 다음 예제에서 현재 환경은 Python 3.6(32비트)입니다.

    Visual Studio에서 단색 재생 화살표를 사용하여 디버깅으로 프로그램을 시작하는 방법을 보여 주는 스크린샷.

    도구 모음에 현재 Python 환경이 표시되지 않으면 보기>다른 창>Python 환경을 선택합니다.

  3. 프로그램이 실행되면 Visual Studio에서 명령 창을 열어 프로그램 출력을 표시합니다.

    실행 중인 Python 코드의 프로그램 출력에 대해 Visual Studio 2022가 열리는 출력 창의 스크린샷.

    실행 중인 Python 코드에서 프로그램 출력을 위해 Visual Studio가 열리는 출력 창의 스크린샷.

    참고 항목

    디버깅을 사용하여 python-koans 프로그램을 실행하는 경우 프로그램 실행을 완료하려면 코드의 값을 변경해야 합니다.

  4. 다른 Python 환경에서 코드를 실행할 수 있습니다.

    1. Visual Studio 도구 모음에서 현재 Python 환경 드롭다운 목록을 확장하고 원하는 환경을 선택합니다.

    2. 프로그램을 다시 시작합니다.

  5. Visual Studio에서 코드 폴더를 닫을 준비가 되면 파일>폴더 닫기를 선택합니다.

작업 디렉터리 설정

기본적으로 Visual Studio는 해당 폴더의 루트에 폴더로 열린 Python 프로젝트를 실행합니다. 그러나 프로젝트의 코드는 Python이 하위 폴더에서 실행될 것으로 예상할 수 있습니다. 코드가 Visual Studio에서 인식하는 기본 구성과 다른 위치에서 파일을 찾을 것으로 예상되는 경우 코드를 실행하려고 할 때 오류가 발생할 수 있습니다.

python_koans 리포지토리의 루트 폴더를 열고 contemplate-koans.py Python 파일이 포함된 python3이라는 하위 폴더를 확인한다고 가정합니다. python3/contemplate-koans.py 파일을 시작 파일로 설정하기로 결정했습니다. 코드를 실행하면 koans.txt라는 파일을 찾을 수 없다는 오류가 표시됩니다. 이 오류는 contemplate-koans.py 파일에서 Python이 리포지토리 루트가 아닌 python3 폴더에서 실행되기 때문에 발생합니다.

이런 경우도 시작 구성 JSON 파일에 줄을 추가하여 작업 디렉터리를 지정해야 합니다.

  1. 솔루션 탐색기에서 Python(.py) 시작 파일을 마우스 오른쪽 단추로 클릭하고 디버그 구성 추가를 선택합니다.

    Visual Studio 2022의 솔루션 탐색기 선택한 파일에 대한 디버그 구성 추가 옵션을 선택하는 방법을 보여 주는 스크린샷.

  2. 디버거 선택 대화 상자에서 목록에서 기본 옵션을 선택한 다음 선택을 선택합니다.

    Visual Studio 2022의 디버거 선택 대화 상자에서 기본 디버거를 선택하는 방법을 보여 주는 스크린샷.

    참고 항목

    기본값이 옵션으로 표시되지 않으면 디버그 구성 추가 명령을 선택할 때 Python .py 파일을 선택해야 합니다. Visual Studio는 파일 형식을 사용하여 표시할 디버거 옵션을 결정합니다.

  3. Visual Studio는 숨겨진 .vs 폴더에 있는 launch.vs.json 파일을 엽니다. 이 파일은 프로젝트의 디버깅 컨텍스트를 설명합니다. 작업 디렉터리를 지정하려면 "workingDirectory" 속성 값을 추가합니다. python-koans 예제에서는 다음과 같은 속성과 값 "workingDirectory": "python3"을 추가할 수 있습니다.

    {
      "version": "0.2.1",
      "defaults": {},
      "configurations": [
        {
          "type": "python",
          "interpreter": "(default)",
          "interpreterArguments": "",
          "scriptArguments": "",
          "env": {},
          "nativeDebug": false,
          "webBrowserUrl": "",
          "project": "contemplate_koans.py",
          "projectTarget": "",
          "name": "contemplate_koans.py",
          "workingDirectory": "python3"
        }
      ]
    }
    
  4. launch.vs.json 파일에 변경 내용을 저장합니다.

  5. 프로그램을 다시 실행합니다. 이제 지정된 폴더에서 코드 실행이 실행됩니다.

  1. 솔루션 탐색기에서 Python(.py) 시작 파일을 마우스 오른쪽 단추로 클릭하고 디버그 및 시작 설정을 선택합니다.

    Visual Studio의 솔루션 탐색기 선택한 파일에 대한 디버그 및 시작 설정 옵션을 선택하는 방법을 보여 주는 스크린샷.

  2. 디버거 선택 대화 상자에서 목록에서 기본 옵션을 선택한 다음 선택을 선택합니다.

    Visual Studio에서 디버거 선택 대화 상자에서 기본 디버거를 선택하는 방법을 보여 주는 스크린샷.

    참고 항목

    기본값이 옵션으로 표시되지 않으면 디버그 및 시작 설정 명령을 선택할 때 Python .py 파일을 선택해야 합니다. Visual Studio는 파일 형식을 사용하여 표시할 디버거 옵션을 결정합니다.

  3. Visual Studio는 숨겨진 .vs 폴더에 있는 launch.vs.json 파일을 엽니다. 이 파일은 프로젝트의 디버깅 컨텍스트를 설명합니다. 작업 디렉터리를 지정하려면 "workingDirectory" 속성 값을 추가합니다. python-koans 예제에서는 다음과 같은 속성과 값 "workingDirectory": "python3"을 추가할 수 있습니다.

    {
      "version": "0.2.1",
      "defaults": {},
      "configurations": [
        {
          "type": "python",
          "interpreter": "(default)",
          "interpreterArguments": "",
          "scriptArguments": "",
          "env": {},
          "nativeDebug": false,
          "webBrowserUrl": "",
          "project": "contemplate_koans.py",
          "projectTarget": "",
          "name": "contemplate_koans.py",
          "workingDirectory": "python3"
        }
      ]
    }
    
  4. launch.vs.json 파일에 변경 내용을 저장합니다.

  5. 프로그램을 다시 실행합니다. 이제 지정된 폴더에서 코드 실행이 실행됩니다.