Szybki start: tworzenie pierwszej aplikacji internetowej w języku Python przy użyciu Visual Studio

W tym 5-10-minutowym wprowadzeniu do środowiska VISUAL STUDIO ide języka Python utworzysz prostą aplikację internetową w języku Python opartą na platformie Flask. Projekt można utworzyć za pomocą dyskretnych kroków, które Visual Studio podstawowych funkcji programu .

Jeśli jeszcze nie zainstalowano aplikacji Visual Studio, przejdź do strony pobierania Visual Studio, aby zainstalować ją bezpłatnie. W instalatorze wybierz obciążenie Programowanie w języku Python .

Jeśli jeszcze nie zainstalowano aplikacji Visual Studio, przejdź do strony pobierania Visual Studio, aby zainstalować ją bezpłatnie. W instalatorze wybierz obciążenie Programowanie w języku Python .

Jeśli jeszcze nie zainstalowano aplikacji Visual Studio, przejdź do strony pobierania Visual Studio, aby zainstalować ją bezpłatnie. W witrynie Instalator programu Visual Studio obciążenie Programowanie w języku Python, a następnie w szczegółach instalacji wybierz pozycję Obsługa sieci Web języka Python.

Zrzut ekranu przedstawiający Instalator programu Visual Studio z wybranym obciążeniem Programowanie w języku Python i wybraną obsługą sieci Web języka Python.

Tworzenie projektu

Poniższe kroki tworzą pusty projekt, który służy jako kontener dla aplikacji:

  1. Otwórz program Visual Studio 2017.

  2. Na górnym pasku menu wybierz pozycję File > New > Project (Nowy > Project).

  3. W oknie dialogowym Nowy Project wprowadź tekst "Python Web Project" w polu wyszukiwania w prawym górnym rogu, wybierz pozycję Projekt sieci Web na środkowej liście, nadaj projektowi nazwę, na przykład "HelloPython", a następnie wybierz przycisk OK.

    Okno dialogowe Nowy projekt z wybraną oknie Project Python

    Jeśli nie widzisz szablonów projektów języka Python, uruchom polecenie Instalator programu Visual Studio, > wybierz pozycję Więcej modyfikacji, wybierz obciążenie Programowanie w języku Python, a następnie wybierz pozycję Modyfikuj.

    Obciążenie programowania w języku Python w Visual Studio instalatora

  4. Nowy projekt zostanie otwarty w Eksplorator rozwiązań okienku po prawej stronie. W tym momencie projekt jest pusty, ponieważ nie zawiera żadnych innych plików.

    Eksplorator rozwiązań z nowo utworzonym pustym projektem

  1. Otwórz Visual Studio 2019 r.

  2. Na ekranie startowym wybierz pozycję Utwórz nowy projekt.

  3. W oknie dialogowym Tworzenie nowego projektu wprowadź tekst "Python web" w polu wyszukiwania u góry, wybierz pozycję Web Project na środkowej liście, a następnie wybierz pozycję Dalej:

    Ekran Tworzenia nowego projektu z wybraną pozycję Python Web Project Jeśli nie widzisz szablonów projektów języka Python, uruchom skrypt Instalator programu Visual Studio,  > wybierz pozycję Więcej modyfikacji, wybierz obciążenie Programowanie w języku Python, a następnie wybierz pozycję Modyfikuj.

    Obciążenie programowania w języku Python w Visual Studio instalatora

  4. W oknie dialogowym Konfigurowanie nowego projektu wprowadź wartość "HelloPython" w Project, określ lokalizację i wybierz pozycję Utwórz. (Nazwa rozwiązania jest automatycznie ustawiana tak, aby Project nazwę rozwiązania).

    Okno dialogowe konfigurowania nowego projektu

  5. Nowy projekt zostanie otwarty w Eksplorator rozwiązań okienku po prawej stronie. W tym momencie projekt jest pusty, ponieważ nie zawiera żadnych innych plików.

    Zrzut ekranu przedstawiający nowo utworzony pusty projekt w Eksplorator rozwiązań.

  1. Otwórz Visual Studio 2022 r.

  2. Na ekranie startowym wybierz pozycję Utwórz nowy projekt.

  3. W oknie dialogowym Tworzenie nowego projektu wprowadź tekst "Python web" w polu wyszukiwania u góry. Wybierz pozycję Project z listy, a następnie wybierz pozycję Dalej:

    Zrzut ekranu przedstawiający ekran Tworzenie nowego projektu z wybranymi Project Python.

    Jeśli nie widzisz szablonów projektów internetowych języka Python, wybierz pozycję NarzędziaPozyskaj narzędzia i funkcje, > aby uruchomić Instalator programu Visual Studio. W instalatorze wybierz obciążenie Programowanie w języku Python , a następnie w obszarze Szczegóły instalacji wybierz pozycję Obsługa sieci Web języka Python. Następnie wybierz pozycję Modyfikuj.

  4. W oknie dialogowym Konfigurowanie nowego projektu wprowadź wartość "HelloPython" w polu Project, określ lokalizację, a następnie wybierz pozycję Utwórz. Nazwa rozwiązania jest automatycznie aktualizowana w celu Project nazwy.

    Zrzut ekranu przedstawiający okno dialogowe Konfigurowanie nowego projektu.

Nowy projekt zostanie otwarty w Eksplorator rozwiązań okienku po prawej stronie. W tym momencie projekt jest pusty, ponieważ nie zawiera żadnych innych plików.

Zrzut ekranu przedstawiający Eksplorator rozwiązań z nowo utworzonym pustym projektem.

Pytanie: Jakie są zalety tworzenia projektu w środowisku Visual Studio dla aplikacji w języku Python?

Odpowiedź: Aplikacje w języku Python są zwykle definiowane przy użyciu tylko folderów i plików, ale ta prosta struktura może być uciążliwa w przypadku większych aplikacji. Aplikacje mogą obejmować automatycznie generowane pliki, język JavaScript dla aplikacji internetowych i inne składniki. Projekt Visual Studio pomaga zarządzać tą złożonością.

Projekt, plik pyproj , identyfikuje wszystkie pliki źródłowe i pliki zawartości skojarzone z projektem. Plik pyproj zawiera informacje o kompilacji dla każdego pliku, przechowuje informacje w celu integracji z systemami kontroli źródła i ułatwia organizowanie aplikacji w składniki logiczne.

Pytanie: Co to jest "rozwiązanie" wyświetlane w Eksplorator rozwiązań?

Odpowiedź: Rozwiązanie Visual Studio to kontener, który ułatwia zarządzanie co najmniej jednym powiązanym projektem jako grupą. Rozwiązanie przechowuje ustawienia konfiguracji, które nie są specyficzne dla projektu. Projekty w rozwiązaniu mogą również odwoływać się do siebie nawzajem. Na przykład uruchomienie projektu aplikacji w języku Python może automatycznie skompilować drugi projekt, taki jak rozszerzenie języka C++, z których korzysta aplikacja języka Python.

Instalowanie biblioteki flask

Aplikacje internetowe w języku Python prawie zawsze używają jednej z wielu dostępnych bibliotek języka Python do obsługi szczegółów niskiego poziomu, takich jak kierowanie żądań internetowych i kształtowanie odpowiedzi. Visual Studio udostępnia wiele szablonów dla aplikacji internetowych. Użyj jednego z tych szablonów w dalszej części tego przewodnika Szybki start.

Aby zainstalować bibliotekę flask w domyślnym środowisku globalnym, które Visual Studio używane w tym projekcie, należy wykonać poniższe kroki.

  1. Rozwiń węzeł Środowiska języka Python w projekcie, aby wyświetlić domyślne środowisko dla projektu.

    Eksplorator rozwiązań z domyślnym środowiskiem

  2. Kliknij prawym przyciskiem myszy środowisko i wybierz polecenie Zainstaluj pakiet języka Python. To polecenie otwiera okno Środowiska języka Python na karcie Pakiety .

  3. Wprowadź "flask" w polu wyszukiwania i wybierz pozycję pip install flask (zainstaluj pip) z pakietu PyPI. Zaakceptuj wszelkie monity o uprawnienia administratora i obserwuj postęp w oknie Visual Studio danych wyjściowych. (Monit o podniesienie uprawnień występuje, gdy folder packages dla środowiska globalnego znajduje się w chronionym obszarze, takim jak C:\Program Files).

    Instalowanie biblioteki Flask przy użyciu instalacji narzędzia pip

  1. Rozwiń węzeł Środowiska języka Python w projekcie, aby wyświetlić domyślne środowisko dla projektu.

    Eksplorator rozwiązań z domyślnym środowiskiem

  2. Kliknij prawym przyciskiem myszy środowisko i wybierz pozycję Zarządzaj pakietami języka Python.... To polecenie otwiera okno Środowiska języka Python na karcie Pakiety (PyPI ).

  3. Wprowadź wartość "flask" w polu wyszukiwania. Jeśli poniżej pola wyszukiwania pojawi się komunikat Flask, możesz pominąć ten krok. W przeciwnym razie wybierz pozycję Uruchom polecenie: pip install flask. Zaakceptuj wszelkie monity o uprawnienia administratora i obserwuj postęp w oknie Visual Studio danych wyjściowych. (Monit o podniesienie uprawnień występuje, gdy folder packages dla środowiska globalnego znajduje się w chronionym obszarze, takim jak C:\Program Files).

    Instalowanie biblioteki Flask przy użyciu instalacji narzędzia pip

  1. Rozwiń węzeł Środowiska języka Python w projekcie, aby wyświetlić domyślne środowisko dla projektu.

    Zrzut ekranu przedstawiający domyślne środowisko w Eksplorator rozwiązań.

  2. Kliknij prawym przyciskiem myszy środowisko i wybierz pozycję Zarządzaj pakietami języka Python. To polecenie otwiera okno Środowiska języka Python na karcie Pakiety (PyPI ).

  3. Wprowadź wartość "flask" w polu wyszukiwania. Jeśli poniżej pola wyszukiwania pojawi się komunikat Flask, możesz pominąć ten krok. W przeciwnym razie wybierz polecenie Uruchom: pip install flask.

    Zrzut ekranu przedstawiający instalowanie biblioteki flask przy użyciu instalacji narzędzia pip.

    Jeśli globalny folder pakietów środowiska znajduje się w obszarze chronionym, np. C:\Program Files, zostanie wyświetlony monit o podniesienie uprawnień. Zaakceptuj wszelkie monity o uprawnienia administratora. Obserwuj postęp Visual Studio Dane wyjściowe.

Po zainstalowaniu biblioteka pojawia się w środowisku na Eksplorator rozwiązań, co oznacza, że można jej używać w kodzie języka Python.

Biblioteka Flask zainstalowana i wyświetlona w programie Eksplorator rozwiązań

Biblioteka Flask zainstalowana i wyświetlona w programie Eksplorator rozwiązań

Zrzut ekranu przedstawiający bibliotekę Flask zainstalowaną i wyświetloną w Eksplorator rozwiązań.

Uwaga

Zamiast instalować biblioteki w środowisku globalnym, deweloperzy zwykle tworzą "środowisko wirtualne", w którym mają być zainstalowane biblioteki dla określonego projektu. Visual Studio zwykle oferują tę opcję, jak omówiono w przewodniku Szybki start — Tworzenie projektu w języku Python przy użyciu szablonu.

Pytanie: Gdzie mogę dowiedzieć się więcej o innych dostępnych pakietach języka Python?

Odpowiedź: Odwiedź stronę indeksu pakietów języka Python.

Dodawanie pliku kodu

Teraz możesz dodać trochę kodu w języku Python, aby zaimplementować minimalną aplikację internetową.

  1. Kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań a następnie wybierz pozycję Dodaj > nowy element.

  2. W wyświetlonym oknie dialogowym wybierz pozycję Pusty plik python, nadaj app.py i wybierz pozycję Dodaj. Visual Studio automatycznie otwiera plik w oknie edytora.

  3. Skopiuj następujący kod i wklej go do app.py:

    from flask import Flask
    
    # Create an instance of the Flask class that is the WSGI application.
    # The first argument is the name of the application module or package,
    # typically __name__ when using a single module.
    app = Flask(__name__)
    
    # Flask route decorators map / and /hello to the hello function.
    # To add other resources, create functions that generate the page contents
    # and add decorators to define the appropriate resource locators for them.
    
    @app.route('/')
    @app.route('/hello')
    def hello():
        # Render the page
        return "Hello Python!"
    
    if __name__ == '__main__':
        # Run the app server on localhost:4449
        app.run('localhost', 4449)
    
  1. Kliknij prawym przyciskiem myszy projekt w Eksplorator rozwiązań a następnie wybierz pozycję Dodaj > nowy element.

  2. W wyświetlonym oknie dialogowym wybierz pozycję puste. W polach Nazwa wprowadź app.py, a następnie wybierz pozycję Dodaj. Visual Studio automatycznie otwiera plik w oknie edytora.

  3. Skopiuj następujący kod i wklej go do app.py:

    from flask import Flask
    
    # Create an instance of the Flask class that is the WSGI application.
    # The first argument is the name of the application module or package,
    # typically __name__ when using a single module.
    app = Flask(__name__)
    
    # Flask route decorators map / and /hello to the hello function.
    # To add other resources, create functions that generate the page contents
    # and add decorators to define the appropriate resource locators for them.
    
    @app.route('/')
    @app.route('/hello')
    def hello():
        # Render the page
        return "Hello Python!"
    
    if __name__ == '__main__':
        # Run the app server on localhost:4449
        app.run('localhost', 4449)
    

Możesz zauważyć > , że w oknie dialogowym DodawanieNowego elementu jest wyświetlanych wiele innych typów plików, które można dodać do projektu języka Python, w tym klasę języka Python, pakiet języka Python, test jednostkowy języka Python,web.config plików i inne. Ogólnie rzecz biorąc, te szablony elementów to doskonały sposób na szybkie tworzenie plików z przydatnym kodem wzorcowym.

Pytanie: Gdzie mogę dowiedzieć się więcej o flask?

Odpowiedź: Zapoznaj się z dokumentacją flask, zaczynając od przewodnika Szybki start flask.

Uruchamianie aplikacji

  1. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy pozycję app.py a następnie wybierz pozycję Ustaw jako plik startowy z menu rozwijanego. To polecenie identyfikuje plik kodu do uruchomienia w języku Python podczas uruchamiania aplikacji.

    Ustawianie pliku startowego projektu w programie Eksplorator rozwiązań

    Ustawianie pliku startowego projektu w programie Eksplorator rozwiązań

    Zrzut ekranu przedstawiający ustawianie pliku startowego projektu w programie Eksplorator rozwiązań.

  2. Kliknij prawym przyciskiem myszy projekt w oknie Eksplorator rozwiązań wybierz pozycję Właściwości. Wybierz kartę Debugowanie z menu Właściwości i ustaw właściwość Numer portu na wartość 4449. To ustawienie zapewnia, Visual Studio uruchamia przeglądarkę z , aby localhost:4449 app.run dopasować argumenty w kodzie.

  3. Wybierz pozycję DebugujStart > bez debugowania lub naciśnij klawisze CtrlF5+, aby zapisywać zmiany w plikach i uruchamiać aplikację.

  4. Zostanie wyświetlone okno polecenia z komunikatem Running in https:/localhost:4449 (Uruchomione w lokalizacji https://localhost:4449). Zostanie otwarte okno przeglądarki z localhost:4449 komunikatem Hello, Python! Żądanie GET jest również wyświetlane w oknie polecenia ze stanem 200.

    Jeśli przeglądarka nie zostanie automatycznie otwarta, uruchom przeglądarkę, a następnie przejdź do .localhost:4449

    Jeśli w oknie polecenia widzisz tylko interaktywną powłokę języka Python lub jeśli to okno miga na ekranie przez krótki czas, upewnij się, że app.py jako plik startowy.

  5. Przejdź do , localhost:4449/hello aby sprawdzić, czy dekorator zasobu /hello również działa. Ponownie żądanie jest GET wyświetlane w oknie polecenia ze stanem 200. Wypróbuj też inne adresy URL, aby zobaczyć, że 404 w oknie polecenia są wyświetlane kody stanu.

  6. Zamknij okno polecenia, aby zatrzymać aplikację, a następnie zamknij okno przeglądarki.

Pytanie: Jaka jest różnica między poleceniami Uruchom bez debugowania i Rozpocznij debugowanie?

Odpowiedź: Uruchom debugowanie umożliwia uruchamianie aplikacji w kontekście Visual Studio debugowania. Za pomocą debugera można ustawiać punkty przerwania, badać zmienne i przechodzić przez kod wiersz po wierszu. Aplikacje mogą działać wolniej w debugerze ze względu na wpięcie, które umożliwia debugowanie.

Uruchom bez debugowania uruchamia aplikację bezpośrednio, tak jakby była uruchamiana z wiersza polecenia, bez kontekstu debugowania. Uruchom bez debugowania również automatycznie uruchamia przeglądarkę i przechodzi do adresu URL określonego na karcie Debugowanie właściwości projektu.

Następne kroki

Gratulujemy uruchomienia pierwszej aplikacji w języku Python z Visual Studio. Wiesz już nieco o używaniu środowiska Visual Studio IDE języka Python!

Ponieważ kroki, które zostały opisane w tym przewodniku Szybki start, są dość ogólne, prawdopodobnie zgadywano, że mogą i powinny być zautomatyzowane. Taka automatyzacja jest rolą Visual Studio szablonów projektów. Przejdź przez przewodnik Szybki start — tworzenie projektu w języku Python przy użyciu szablonu w celu utworzenia aplikacji internetowej podobnej do opisanej w tym artykule, ale z mniejszą liczbą kroków.

Aby kontynuować pracę z pełniejszego samouczka na temat języka Python w usłudze Visual Studio, w tym korzystania z okna interaktywnego, debugowania, wizualizacji danych i pracy z usługą Git, wykonaj kroki samouczka Samouczek: wprowadzenie do języka Python w usłudze Visual Studio.

Aby dowiedzieć się więcej Visual Studio do zaoferowania, wybierz poniższe linki.