빠른 시작: 폴더에서 Python 코드 열기 및 실행Quickstart: Open and run Python code in a folder

Visual Studio 2019에서 Python 지원을 설치하면 Visual Studio 프로젝트를 만들지 않고도 Visual Studio 2019에서 기존 Python 코드를 쉽게 실행할 수 있습니다.Once you've installed Python support in Visual Studio 2019, it's easy to run existing Python code in Visual Studio 2019 without creating a Visual Studio project.

참고

Visual Studio 2017 및 이전 버전에서는 Visual Studio 프로젝트를 만들어야 Python 코드를 실행할 수 있으며, 이러한 작업은 기본 제공 프로젝트 템플릿을 사용하여 쉽게 수행할 수 있습니다.Visual Studio 2017 and earlier require you to create a Visual Studio project to run Python code, which you can easily do using a built-in project template. 빠른 시작: 기존 코드에서 Python 프로젝트 만들기를 참조하세요.See Quickstart: Create a Python project from existing code

  1. 이 연습에서는 원하는 Python 코드가 있는 폴더를 사용할 수 있습니다.For this walkthrough, you can use any folder with Python code that you like. 여기에 나와 있는 예제를 계속 진행하려면 적합한 폴더에서 git clone https://github.com/gregmalcolm/python_koans 명령을 사용하여 gregmalcolm/python_koans GitHub 리포지토리를 컴퓨터에 복제하세요.To follow along with the example shown here, clone the gregmalcolm/python_koans GitHub repository to your computer using the command git clone https://github.com/gregmalcolm/python_koans in an appropriate folder.

  2. Visual Studio 2019를 시작하고 시작 창에서 시작 열 아래에 있는 열기를 선택합니다.Launch Visual Studio 2019 and in the start window, select Open at the bottom of the Get started column. 또는 이미 Visual Studio를 실행하고 있는 경우 파일 > 열기 > 폴더 명령을 선택합니다.Alternately, if you already have Visual Studio running, select the File > Open > Folder command instead.

    Visual Studio 시작 화면

  3. Python 코드가 있는 폴더로 이동하여 폴더 선택을 선택합니다.Navigate to the folder containing your Python code, then choose Select Folder. python_koans 코드를 사용하고 있는 경우 클론 폴더 내에서 python3 폴더를 선택해야 합니다.If you're using the python_koans code, make sure to select the python3 folder within the clone folder.

    폴더 열기 명령의 폴더 선택 대화 상자

  4. Visual Studio는 폴더 뷰라는 솔루션 탐색기에 폴더를 표시합니다.Visual Studio displays the folder in Solution Explorer in what's called Folder View. 폴더 이름 왼쪽 가장자리에 있는 화살표를 사용하여 폴더를 확장 및 축소할 수 있습니다.You can expand and collapse folders using the arrows on the left edges of the folder names:

    솔루션 탐색기에서 폴더를 확장 및 축소하는 컨트롤

  5. Python 폴더를 열면 Visual Studio는 프로젝트와 관련된 설정을 관리하는 여러 숨겨진 폴더를 만듭니다.When opening a Python folder, Visual Studio creates several hidden folders to manage settings related to the project. 이러한 폴더와 다른 모든 숨겨진 파일 및 폴더(예: .git 폴더)를 보려면 모든 파일 표시 도구 모음 단추를 선택합니다.To see these folders (and any other hidden files and folders, such as the .git folder), select the Show All Files toolbar button:

    솔루션 탐색기의 숨겨진 폴더 뷰

  6. 코드를 실행하려면 먼저 시작 또는 기본 프로그램 파일을 파악해야 합니다.To run the code, you first need to identify the startup or primary program file. 여기에 표시된 예제에서는 시작 파일 contemplate-koans.py입니다.In the example shown here, the startup file contemplate-koans.py. 해당 파일을 마우스 오른쪽 단추로 클릭하고 시작 항목으로 설정을 선택합니다.Right-click that file and select Set as Startup Item.

    솔루션 탐색기에서 시작 항목 설정

    중요

    열린 폴더의 루트에 시작 항목이 없는 경우에도 작업 디렉터리 설정 섹션에 설명된 대로 실행 구성 JSON 파일에 줄을 추가해야 합니다.If your startup item is not located in the root of the folder you opened, you must also add a line to the launch configuration JSON file as described in the section, Set a working directory.

  7. Ctrl+F5를 누르거나 디버그 > 디버깅 없이 시작을 선택하여 코드를 실행합니다.Run the code by pressing Ctrl+F5 or selecting Debug > Start without Debugging. Visual Studio 디버거에서 코드를 실행하는 시작 항목을 재생 단추와 함께 표시하는 도구 모음 단추를 선택할 수도 있습니다.You can also select the toolbar button that shows the startup item with a play button, which runs code in the Visual Studio debugger. 모든 경우에서 Visual Studio가 시작 항목이 Python 파일임을 감지하므로 자동으로 기본 Python 환경에서 코드를 실행합니다.In all cases, Visual Studio detects that your startup item is a Python file, so it automatically runs the code in the default Python environment. (해당 환경은 도구 모음의 시작 항목 오른쪽에 표시됩니다.)(That environment is shown to the right of the startup item on the toolbar.)

    디버거 시작 도구 모음 단추

  8. 프로그램 출력이 별도의 명령 창에 표시됩니다.The program's output appears in a separate command window:

    Python 코드 실행 출력 창

  9. 다른 환경에서 코드를 실행하려면 도구 모음의 드롭다운 컨트롤에서 해당 환경을 선택하고 시작 항목을 다시 시작합니다.To run the code in a different environment, select that environment from the drop-down control on the toolbar, then launch the startup item again.

  10. Visual Studio에서 폴더를 닫으려면 파일 > 폴더 닫기 메뉴 명령을 선택합니다.To close the folder in Visual Studio, select the File > Close folder menu command.

작업 디렉터리 설정Set a working directory

기본적으로 Visual Studio는 해당 폴더의 루트에 폴더로 열린 Python 프로젝트를 실행합니다.By default, Visual Studio runs a Python project opened as a folder in the root of that same folder. 하지만 프로젝트의 코드는 Python이 하위 폴더에서 실행되고 있다고 가정할 수 있습니다.The code in your project, however, might assume that Python is being run in a subfolder. 예를 들어 python_koans 리포지토리의 루트 폴더를 열고 python3/contemplate-koans.py 파일을 시작 항목으로 설정한다고 가정해보겠습니다.For example, suppose you open the root folder of the python_koans repository and then set the python3/contemplate-koans.py file as startup item. 그런 다음, 코드를 실행하면 koans.txt 파일을 찾을 수 없다는 오류가 표시됩니다.If you then run the code, you see an error that the koans.txt file cannot be found. 이 오류는 contemplate-koans.py에서 Python이 리포지토리 루트가 아닌 python3 폴더에서 실행되고 있다고 가정하기 때문에 발생합니다.This error happens because contemplate-koans.py assumes that Python is being run in the python3 folder rather than the repository root.

이런 경우도 시작 구성 JSON 파일에 줄을 추가하여 작업 디렉터리를 지정해야 합니다.In such cases, you must also add a line to the launch configuration JSON file to specify the working directory:

  1. 솔루션 탐색기에서 Python( .py) 시작 파일을 마우스 오른쪽 단추로 클릭하고 디버그 및 시작 설정을 선택합니다.Right-click the Python (.py) startup file in Solution Explorer and select Debug and Launch Settings.

    Python 파일의 디버그 및 시작 설정 명령

  2. 표시되는 디버거 선택 대화 상자에서 기본값, 선택을 차례로 누릅니다.In the Select debugger dialog box that appears, select Default and then choose Select.

    Python 파일의 디버그 및 시작 설정 명령

    참고

    선택 항목으로 기본값이 표시되지 않는 경우 디버그 및 시작 설정 명령을 선택할 때 Python .py 파일을 마우스 오른쪽 단추로 클릭했는지 확인하세요.If you don't see Default as a choice, be sure that you right-clicked a Python .py file when selecting the Debug and Launch Settings command. Visual Studio는 파일 형식을 사용하여 표시할 디버거 옵션을 결정합니다.Visual Studio uses the file type to determine while debugger options to display.

  3. Visual Studio는 숨겨진 .vs 폴더에 있는 launch.vs.json 파일을 엽니다.Visual Studio opens a file named launch.vs.json, which is located in the hidden .vs folder. 이 파일은 프로젝트의 디버깅 컨텍스트를 설명합니다.This file describes the debugging context for the project. 작업 디렉터리를 지정하려면 python-koans 예제의 "workingDirectory": "python3"와 같이 "workingDirectory"에 대한 값을 추가하세요.To specify a working directory, add a value for "workingDirectory", as in "workingDirectory": "python3" for python-koans example:

    {
      "version": "0.2.1",
      "defaults": {},
      "configurations": [
        {
          "type": "python",
          "interpreter": "(default)",
          "interpreterArguments": "",
          "scriptArguments": "",
          "env": {},
          "nativeDebug": false,
          "webBrowserUrl": "",
          "project": "python3\\contemplate_koans.py",
          "name": "contemplate_koans.py",
          "workingDirectory": "python3"
        }
      ]
    }
    
  4. 파일을 저장하고 프로그램을 다시 시작하면 이제 지정된 폴더에서 프로그램이 실행됩니다.Save the file and launch the program again, which now runs in the specified folder.

다음 단계Next steps

참조See also