Delen via

Quickstart: Een opslagplaats met Python-code klonen in Visual Studio

In deze quickstart volgt u de begeleide stappen om een GitHub-opslagplaats met Python-code te klonen en een project te maken. Met Visual Studio kunt u eenvoudig met Python-projecten werken met behulp van Git-opdrachten voor toegang tot inhoud onder broncodebeheer. U kunt ook Python-codeopslagplaatsen klonen vanaf de opdrachtregel en vervolgens met de projecten in Visual Studio werken.

Vereiste voorwaarden

  • Visual Studio 2022 geïnstalleerd met ondersteuning voor Python-workloads. Visual Studio 2022 biedt naadloze integratie met GitHub met ondersteuning voor Git-opdrachten. Zie Python-ondersteuning installeren in Visual Studiovoor meer informatie.

  • Visual Studio geïnstalleerd met ondersteuning voor Python-workloads, samen met de GitHub-extensie voor Visual Studio. Met deze extensie kunt u werken met GitHub-opslagplaatsen en Git-opdrachten. De GitHub-extensie is beschikbaar in het Visual Studio-installatieprogramma op het tabblad Afzonderlijke onderdelen in de sectie Hulpprogramma's voor code :

    Schermopname die laat zien hoe u de GitHub-extensie selecteert in het Installatieprogramma van Visual Studio.

Visual Studio voor Mac wordt niet ondersteund. Zie Wat gebeurt er met Visual Studio voor Mac voor meer informatie? Visual Studio Code in Windows, Mac en Linux werkt goed met Python via beschikbare extensies.

Bestaande opslagplaatsbestanden klonen

Gebruik de volgende stappen om een bestaande opslagplaats te klonen met behulp van de Git-broncodebeheeropdrachten van Visual Studio:

  1. Selecteer in Visual Studio Git>Clone:

    Schermopname van het selecteren van de optie Git Clone-opslagplaats in Visual Studio 2022.

  2. Specificeer in het dialoogvenster Een repository klonen de GitHub-repository die moet worden gekloond:

    Schermopname van het opgeven van de GitHub-opslagplaats die moet worden gekloond in Visual Studio 2022.

    1. Voer voor de locatie van de opslagplaats de URL in van de opslagplaats die u wilt klonen. Voer voor deze oefening het volgende in https://github.com/gregmalcolm/python_koans.

    2. Voer voor het Pad de map in op uw systeem waarin Visual Studio de gekloonde bestanden moet opslaan.

      De map die u opgeeft, moet de exacte map zijn die u in Visual Studio wilt gebruiken. In tegenstelling tot de git clone opdracht, maakt Visual Studio bij het maken van een kloon in Team Explorer niet automatisch een nieuwe submap met de naam van de opslagplaats.

    3. Wanneer u klaar bent, selecteert u Klonen.

    Nadat het klonen is voltooid, opent Visual Studio het deelvenster Git-wijzigingen voor de opslagplaats. U kunt de map ook zien met de gekloonde opslagplaatsbestanden in Solution Explorer.

  3. SelecteerLokale Git-opslagplaatsen> en controleer of de gekloonde opslagplaats nu in de lijst staat:

    Schermopname van het weergeven van de lijst met lokale GitHub-opslagplaatsen die beschikbaar zijn in Visual Studio 2022.

Gebruik de volgende stappen om een bestaande opslagplaats te klonen met behulp van Visual Studio Team Explorer:

  1. In Visual Studio, selecteer Beeld>Teamverkenner om het Teamverkenner-venster te openen. Op de pagina Verbinding maken hebt u toegang tot GitHub- of Azure DevOps-opslagplaatsen of kloont u een opslagplaats.

    Schermopname van de pagina Team Explorer Connect met gehoste serviceproviders, waaronder Azure DevOps en GitHub en lokale Git-opslagplaatsen.

    Als Team Explorer niet wordt geopend op de pagina Verbinding maken , selecteert u het plug-pictogram op de werkbalk van Visual Studio om de pagina te openen.

  2. Vouw op de pagina Team Explorer - Verbinding maken de sectie Lokale Git-opslagplaatsen uit en selecteer de optie Klonen .

    1. Voer voor de locatie van de opslagplaats de URL in van de opslagplaats die u wilt klonen. Voer voor deze oefening het volgende in https://github.com/gregmalcolm/python_koans.

    2. Voer voor het pad de map in op uw systeem waar u wilt dat Visual Studio de gekloonde bestanden opslaat.

      De map die u opgeeft, moet de exacte map zijn die u in Visual Studio wilt gebruiken. In tegenstelling tot de git clone opdracht, maakt Visual Studio bij het maken van een kloon in Team Explorer niet automatisch een nieuwe submap met de naam van de opslagplaats.

    3. Selecteer de Submodules recursief klonen optie.

    4. Selecteer Klonen onder aan de pagina.

Nadat het klonen is voltooid, wordt de naam van de opslagplaats weergegeven in de lijst met lokale Git-opslagplaatsen .

Belangrijk

In deze quickstart maakt u een directe kloon van de python_koans opslagplaats op GitHub. Een dergelijke opslagplaats wordt door de auteur beveiligd tegen directe wijzigingen, waardoor het doorvoeren van wijzigingen in de opslagplaats mislukt. In de praktijk splitsen ontwikkelaars in plaats daarvan een dergelijke opslagplaats naar hun eigen GitHub-account, brengen ze daar wijzigingen aan en maken ze vervolgens pull-aanvragen om deze wijzigingen in te dienen bij de oorspronkelijke opslagplaats. Wanneer u uw eigen fork hebt, gebruikt u de BIJBEHORENDE URL in plaats van de oorspronkelijke opslagplaats-URL die u eerder hebt gebruikt.

Project maken van gekloonde bestanden

Nadat u de opslagplaats hebt gekloond, kunt u een nieuw project maken op basis van de gekloonde bestanden.

Volg deze stappen om een project te maken op basis van bestaande bestanden.

Belangrijk

Het volgende proces verplaatst of kopieert geen oorspronkelijke bronbestanden. Als u met een kopie van uw bestanden wilt werken, moet u eerst de map dupliceren en vervolgens het project maken.

  1. Start Visual Studio en selecteer Bestand>Nieuw>Project.

  2. Zoek in het dialoogvenster Een nieuw project maken naar python en selecteer de Bestaande Python-code sjabloon en selecteer Volgende.

  3. Voer in het dialoogvenster Uw nieuwe project configureren een projectnaam en - locatie in, kies de oplossing die het project moet bevatten en selecteer Maken.

  4. Stel in de wizard Nieuw project maken op basis van bestaande Python-code het mappad in op uw bestaande code, stel een filter voor bestandstypen in en geef alle zoekpaden op die uw project nodig heeft en selecteer vervolgens Volgende. Als u de zoekpaden niet kent, laat u het veld leeg.

    Schermopname van het maken van een nieuw project op basis van bestaande code, waaronder het kiezen van het mappad, filters voor bestandstypen en zoekpaden.

  5. Selecteer op de volgende pagina het opstartbestand voor uw project. Visual Studio selecteert de standaard globale Python-interpreter en -versie. U kunt de omgeving wijzigen met behulp van de vervolgkeuzelijst. Wanneer u klaar bent, selecteert u Volgende.

    Opmerking

    In het dialoogvenster worden alleen bestanden in de hoofdmap weergegeven. Als het gewenste bestand zich in een submap bevindt, laat u het opstartbestand leeg. U kunt het opstartbestand instellen in Solution Explorer, zoals beschreven in een latere stap.

    Schermopname van het venster Nieuw project maken vanuit bestaand codevenster, inclusief het kiezen van het opstartbestand en de Python-omgeving.

  6. Selecteer de locatie voor het opslaan van het projectbestand (een .pyproj-bestand op schijf). Indien van toepassing, kunt u ook automatische detectie van virtuele omgevingen opnemen en het project aanpassen voor verschillende webframeworks. Als u niet zeker weet wat deze opties zijn, laat u de velden ingesteld op de standaardwaarden.

    Schermopname van het maken van een nieuw project vanuit het venster Bestaande code, inclusief de locatie voor het projectbestand en andere optionele instellingen.

  7. Selecteer en voltooi.

    Visual Studio maakt het project en opent het in Solution Explorer. Als u het .pyproj-bestand naar een andere locatie wilt verplaatsen, selecteert u het bestand in Solution Exploreren selecteertu >Opslaan als op de werkbalk. Met deze actie worden bestandsverwijzingen in het project bijgewerkt, maar worden er geen codebestanden verplaatst.

  8. Als u een ander opstartbestand wilt instellen, zoekt u het bestand in Solution Explorer, klikt u met de rechtermuisknop op het bestand en selecteert u Instellen als opstartbestand.

  1. Dubbelklik in de lijst Met lokale Git-opslagplaatsen op de naam van de opslagplaats. Het dashboard van de opslagplaats wordt geopend op de startpagina van Team Explorer met opties voor GitHub, Project en Oplossingen .

  2. Vouw de sectie Oplossingen uit en selecteer Nieuw om een nieuw project te maken.

    Schermopname van de startpagina van Team Explorer waarin wordt getoond hoe u een nieuw project maakt vanuit een gekloonde opslagplaats.

  3. Stel in het dialoogvenster Een nieuw project maken het taalfilter in op Python (of zoek naar Python), selecteer de sjabloon Bestaande Python-code en selecteer Volgende.

  4. Voer in het dialoogvenster Uw nieuwe project configureren een projectnaam in, stel de locatie in op dezelfde map als de opslagplaats en selecteer OK. De wizard Nieuw project maken op basis van bestaande Python-code wordt geopend.

  5. Selecteer Voltooien in de wizard.

Projecteigenschappen configureren

Als u het project wilt uitvoeren, moet u de werkmap voor het project identificeren en Visual Studio laten weten welk bestand moet worden gebruikt als opstartbestand.

Volg deze stappen om uw projecteigenschappen te configureren:

  1. Vouw in Solution Explorer het projectknooppunt uit, klik met de rechtermuisknop op het contemplate_koans.py-bestand en selecteer Instellen als opstartbestand. Met deze actie weet Visual Studio welk bestand moet worden gebruikt om het project uit te voeren.

  2. Selecteer opde hoofdwerkbalk van Visual Studio> om de eigenschappen voor het project te openen.

  3. Bekijk op het tabblad Algemeen de waarde van de werkmap voor het project.

    Visual Studio stelt de werkmap standaard in op de hoofdmap van het project (.). U ziet dat het opstartbestand geen specifieke maplocatie heeft.

    Schermopname van de huidige werkmap voor het Python-project dat is ingesteld op de hoofdmap van het project.

    De gekloonde programmacode zoekt naar een bestand met de naam koans.txt in de werkmap. De code verwacht dat de map de maplocatie is waar u Visual Studio opdracht gaf om de gekloonde opslagplaatsbestanden op te slaan. Als u de werkmap instelt op de hoofdmap van het project (.), genereert het programma runtime-fouten.

  4. Stel de waarde van de werkmap in op de maplocatie van de gekloonde opslagplaats, zoals C:\Users\contoso\source\repos\Python-Koans.

    Aanbeveling

    Een snelle manier om de maplocatie voor de gekloonde bestanden te bevestigen, is door de eigenschappen van het gekloonde bestand in Solution Explorer te controleren. Klik met de rechtermuisknop op het koans.txt bestand en selecteer Eigenschappen om het detailvenster onder Solution Explorer te openen. In het detailvenster ziet u dat de maplocatie voor het bestand wordt vermeld in de eigenschap Volledig pad . U kunt deze waarde in het veld Werkmap plakken op de pagina Eigenschappen van het project.

  5. Sla de wijzigingen op en sluit het deelvenster Projecteigenschappen .

Python-programma uitvoeren

Nu bent u klaar om de toepassing uit te voeren voor het nieuwe project:

  1. Selecteer Foutopsporing>starten zonder foutopsporing (of gebruik de sneltoets Ctrl+F5) om het programma uit te voeren.

    Als u een FileNotFoundError-runtimefout voor het koans.txt-bestand ziet, controleert u of de werkmap juist is ingesteld, zoals beschreven in de vorige sectie.

  2. Wanneer het programma wordt uitgevoerd, wordt er een assertiefout weergegeven op regel 17 van het projectbestand /koans/about_asserts.py:

    Schermopname van de eerste uitvoer van het Python koans-programma dat een assertiefout produceert in het about_asserts-bestand.

    De assertiefout is opzettelijk. Het programma is ontworpen om Python te leren door alle opzettelijke fouten te corrigeren. Meer informatie over het programma vindt u in Ruby Koans, dat Python Koans inspireerde.

  3. Sluit het programma af.

  4. Dubbelklik in Solution Explorer op het bestand /koans/about_asserts.py om het bestand in de editor te openen:

    Schermopname van het openen van het about_asserts-bestand in Visual Studio.

    Regelnummers worden standaard niet weergegeven in de editor. Als u de regelnummers wilt zien, selecteert u Extra>opties, vouwt u de sectie Alle instellingentaal>>Python>Algemeen uit en selecteert u de optie Regelnummers:

    Schermopname van het inschakelen van regelnummering in de editor met de optie Algemene regelnummers van Talen voor Python.

    In de editor worden regelnummers standaard niet weergegeven. Als u de regelnummers wilt zien, selecteert uExtra-opties>, vouwt u de sectie Teksteditor>Python>Algemeen uit en selecteert u de optie Regelnummers:

    Schermopname van het inschakelen van regelnummers in de editor met de optie Algemene regelnummers voor Python-teksteditor.

    Regelnummers worden standaard niet weergegeven in de editor. Als u de regelnummers wilt zien, selecteert u Extra>Opties en selecteert u Alle instellingen weergeven onder aan het dialoogvenster. Vouw de sectiePython-algemeen>> uit en selecteer de optie Regelnummers:

    Schermopname van het inschakelen van regelnummers voor Python-codebestanden.

  5. Corrigeer de fout in het bestand /koans/about_asserts.py door het False argument op regel 17 te wijzigen in True. De bijgewerkte code moet er als volgt uitzien:

    self.assertTrue(True) # This value should be True

  6. Voer het programma opnieuw uit.

    Als Visual Studio waarschuwt voor fouten, reageert u met Ja om door te gaan met het uitvoeren van de code. Deze keer passeert het programma de eerste controle en stopt het op de volgende koan. U kunt verdere fouten blijven corrigeren en het programma uitvoeren om de aanpassingen te bekijken.

Verwante inhoud

  • Last updated on