Oefening: Hallo wereld

  • 6 minuten

In deze sectie schrijft u uw eerste Go-programma om een bericht af te drukken op het scherm. Deze oefening is een typische manier om aan de slag te gaan in een programmeertaal. U leert meer over de Go-opdrachtregelinterface (CLI) en hoe u een Go-toepassing bouwt en uitvoert.

De IDE configureren om te openen vanuit de CLI

U kunt de Visual Studio Code IDE openen vanuit uw CLI-prompt en beginnen met het bewerken van de bestanden in uw huidige werkruimte. Deze IDE-functie wordt geïmplementeerd met behulp van de omgevingsvariabele $PATH (of $Path). Wanneer de functie is ingeschakeld, kunt u de code . opdracht van de CLI gebruiken om de IDE te openen en bestanden in uw huidige map te bewerken.

Sommige installaties van Visual Studio Code voegen standaard ondersteuning voor de CLI toe aan de $PATH variabele. Mogelijk ziet u deze optie tijdens het installatieproces. Als u deze instelling al hebt geconfigureerd, bent u klaar. Anders moet u mogelijk de volgende stappen uitvoeren om deze functie te kunnen gebruiken.

Linux of macOS

Volg deze stappen om de Visual Studio Code CLI te registreren in uw $PATH omgevingsvariabele:

  1. Open Visual Studio Code.

  2. Selecteer onder Weergave het opdrachtpalet.

  3. Voer in het zoekvak de shell-opdracht in. Terwijl u typt, wordt het resultatenfilter gefilterd.

  4. Kies de Shell-opdracht: installeer de opdracht 'code' in de opdracht PATH .

  5. Sluit de geopende opdracht- of terminalprompt.

    Belangrijk

    Als u een open prompt van het vorige exericse hebt, sluit u de prompt en opent u een nieuwe prompt. Deze stap is nodig om de nieuwe $PATH waarde van kracht te laten worden.

  6. Sluit Visual Studio Code.

Windows

Volg deze stappen om de locatie van de Visual Studio Code CLI toe te voegen aan de omgevingsvariabele van uw $Path systeem:

Notitie

Als u bekend bent met omgevingsvariabelen en weet hoe u een nieuwe locatie toevoegt aan uw $Path systeemvariabele, kunt u de methode gebruiken die het beste voor u werkt. De volgende procedure is een beetje lang, maar het is een geverifieerde methode om ervoor te zorgen dat de variabele correct wordt bijgewerkt.

  1. Open de Windows-Configuratiescherm.

  2. Selecteer Systeem en selecteer vervolgens Geavanceerde systeeminstellingen.

  3. Selecteer in het dialoogvenster Systeemeigenschappen onder Geavanceerd de optie Omgevingsvariabelen. Het dialoogvenster Omgevingsvariabelen bewerken wordt geopend.

    In het dialoogvenster Omgevingsvariabelen bewerken worden twee lijsten weergegeven:

    • Gebruikersvariabelen voor <gebruikersnaam>: Lokale variabeledefinities voor de specifieke gebruiker.
    • Systeemvariabelen: Systeemvariabelendefinities voor alle gebruikers.

    In deze procedure werken we met de systeemvariabelen.

  4. Schuif in het dialoogvenster Omgevingsvariabelen in de keuzelijst Systeemvariabelen naar de padvariabele .

  5. Selecteer de padvariabele om de rij te markeren. Selecteer Bewerken. Het dialoogvenster Omgevingsvariabelen bewerken wordt geopend. In het dialoogvenster worden alle maplocaties weergegeven die in de variabele zijn gedefinieerd.

  6. Selecteer Nieuw in het dialoogvenster Omgevingsvariabelen bewerken. Aan het einde van de lijst wordt een lege rij geopend.

  7. Voer in de lege rij de locatie in van het uitvoerbare bestand van Visual Studio Code CLI. Vervang <user-name> door uw gebruikersnaam.

    C:\Users\<user-name>\AppData\Local\Programs\Microsoft VS Code\bin

  8. Selecteer OK om elk dialoogvenster te sluiten.

  9. Sluit het dialoogvenster Systeemeigenschappen en de Windows-Configuratiescherm.

Stap 1: Open uw Go-werkruimte en de IDE

Nadat u hebt bevestigd dat Visual Studio Code klaar is voor gebruik vanuit de CLI, kunt u uw Go-werkruimte openen.

  1. Open een nieuwe opdracht- of terminalprompt.

  2. Open uw Go-werkruimtemap door de volgende opdracht uit te voeren:

    cd $GOPATH/src

    cd %GOPATH%/src

  3. Gebruik de volgende opdracht om Visual Studio Code vanuit uw werkruimte te openen:

    code .

Visual Studio Code wordt gestart. De Verkenner-weergave wordt aan de linkerkant weergegeven en aan de rechterkant bevindt zich een welkomstpagina .

In de verkennerweergave moet de SRC-sectie van uw Go-project zijn geopend (uitgevouwen). Deze sectie is de map /src voor uw project. Het is momenteel leeg, maar in de volgende stap voegen we enkele inhoud toe.

Stap 2: Een nieuwe map en een Go-bestand maken

Laten we een map en bestand toevoegen aan uw Go-project. Er zijn verschillende manieren in Visual Studio Code om nieuwe items te maken:

  • Acties in het werkbalkmenu:
    • Selecteer >openen en maak vervolgens een nieuwe map.
    • Selecteer Bestand>nieuw bestand en start een nieuw bestand.
  • Koppelingen op de welkomstpagina , die vergelijkbaar zijn met de werkbalkmenuacties.
  • Pictogrammen in de Verkenner-weergave rechts van de SRC-sectie :
    • Selecteer het pictogram Nieuwe map . Typ de mapnaam in het tekstvak en druk op Enter.
    • Selecteer het pictogram Nieuw bestand . Typ de bestandsnaam in het tekstvak en druk op Enter.

Voer de volgende stappen uit in Visual Studio Code. Als u het nieuwe bestand en de nieuwe map wilt maken, gebruikt u het proces dat het beste voor u werkt.

  1. Maak een nieuwe map met de naam helloworld.

  2. Maak een nieuw bestand met de naam main.go voor uw app-code.

  3. Vouw de SRC-weergave Explorer>uit om de structuurstructuur van uw map weer te geven. Dit moet er als volgt uitzien:

    SRC/
        helloworld/
            main.go

Hulpprogramma's voor Go-extensies installeren

Als main.go het eerste Go-bestand is dat u opent in Visual Studio Code, wordt u mogelijk gevraagd om andere hulpprogramma's voor de Go-extensie te installeren. Wanneer u hierom wordt gevraagd, selecteert u Installeren. Onder aan de IDE wordt een terminal geopend om de uitvoer van het proces weer te geven. Als het goed is, ziet u uitvoer zoals in dit voorbeeld:

Omgeving met hulpprogramma's: GOPATH=C:\Projects\Go
5 hulpprogramma's installeren op C:\Projects\Go\bin in de modulemodus.
Installatie van github.com/uudashr/gopkgs/v2/cmd/gopkgs (C:\Projects\Go\bin\gopkgs.exe) GESLAAGD

Controleer tijdens het installatieproces de statusbalk in Visual Studio Code. Als u rechtsonder een bericht ziet, zoals 'Alle hulpprogramma's niet geïnstalleerd', selecteert u het bericht. Selecteer Installeren in het pop-upvenster.

Wanneer het installatieproces is voltooid, wordt in de Terminal-uitvoer een samenvatting weergegeven:

Alle hulpprogramma's zijn geïnstalleerd. U bent klaar voor Go :).

Stap 3: Code toevoegen aan uw Go-bestand

Nu gaan we code toevoegen aan uw Go-bestand.

  1. Voeg in het bestand main.go de volgende code toe:

    package main

import "fmt"

func main() {
    fmt.Println("Hello World!")
}

  2. Sla het bestand op.

U hoeft zich geen zorgen te maken over codeopmaak, zoals tabbladen of spaties. Visual Studio Code formatteert de code automatisch telkens wanneer u het bestand opslaat.

Stap 4: Uw Go-programma uitvoeren

Het Go-programma kan worden uitgevoerd in een opdracht- of terminalprompt of in een terminal die in Visual Studio Code wordt uitgevoerd.

U kunt een bestaande prompt gebruiken of een nieuwe openen. Als u een nieuwe prompt opent, moet u de maplocatie wijzigen in uw Go-werkruimte. Zorg er ook voor dat u het programma uitvoert vanuit de map met uw Go-bestand: $GOPATH/src/helloworld.

Een terminal openen in Visual Studio Code

Als u het programma vanuit Visual Studio Code wilt uitvoeren in plaats van een zelfstandige opdracht- of terminalprompt, voert u de volgende stappen uit:

  1. Selecteer Terminal in Visual Studio Code en selecteer vervolgens Nieuwe terminal.

  2. Selecteer in de vervolgkeuzelijst rechtsboven in de terminal de optie Nieuwe opdrachtprompt.

  3. Voer in de Terminal de volgende opdracht uit om de maplocatie te wijzigen in uw Go-werkruimte en de map met uw Go-bestand:

    cd $GOPATH/src/helloworld

    cd %GOPATH%/src/helloworld

Uw Go-app uitvoeren

Als u uw Go-app wilt uitvoeren, gebruikt u de volgende opdracht in uw Terminal of prompt:

go run main.go

U moet de volgende uitvoer zien:

Hello World!

De go run opdracht doet twee dingen. De app wordt gecompileerd en nadat het compileren is voltooid, wordt de app uitgevoerd.

Een uitvoerbaar bestand maken

Gebruik deze opdracht om een uitvoerbaar bestand voor uw programma te genereren:

go build main.go

Wanneer de go build opdracht is voltooid, wordt er een uitvoerbare app gegenereerd die u op elk gewenst moment kunt uitvoeren zonder verdere verwerking. De opdracht produceert alleen een uitvoerbaar bestand. Het programma wordt niet uitgevoerd zoals de go run opdracht.

De inhoud van /src controleren

Dit is hoe uw project er nu uit moet zien in de SRC-weergave>:

SRC/
    helloworld/
        main
        main.go

In de Verkenner-weergave is de naam van het bestand zonder de extensie het uitvoerbare bestand dat u kunt gebruiken om uw programma uit te voeren. (In Windows heeft dit bestand de .exe extensie.) Wanneer u ontwikkelt, gebruikt u de go run opdracht. Als u de binaire bestanden voor uw toepassing wilt maken, gebruikt u de go build opdracht en implementeert u het binaire uitvoerbare bestand in een juiste omgeving.

Wat heb je net geschreven in Go?

U hebt uw eerste Go-app gemaakt en ervoor gezorgd dat deze wordt gecompileerd en uitgevoerd. Laten we de coderegel per regel bekijken.

We beginnen met de eerste instructie in uw Go-bestand:

package main

De package main instructie is hoe we Go vertellen dat de app die we maken een uitvoerbaar programma is (een bestand dat u kunt uitvoeren). Onze app 'Hallo wereld!' maakt deel uit van het main pakket. Een pakket is een set algemene broncodebestanden. Elke uitvoerbare app heeft deze eerste regel, zelfs als het project of bestand een andere naam heeft.

In de volgende module bekijken we deze concepten nader. Voorlopig moeten we weten dat elk uitvoerbaar programma deel moet uitmaken van het main pakket.

Uitdaging: De pakketnaam wijzigen

Kunt u het belang van het main pakket bevestigen?

  1. Wijzig in het Go-bestand de pakketnaam op de eerste regel.
  2. Sla het bestand op en voer het programma opnieuw uit in de Terminal.

  Wat gebeurt er dan? Ziet u 'Hallo wereld!'? Wordt een binair uitvoerbaar bestand geproduceerd?

 

Antwoord weergeven
"Hallo wereld!" wordt niet weergegeven. Er wordt geen binair uitvoerbaar bestand geproduceerd. Er wordt een foutbericht weergegeven: 'Go run: cannot run non-main package'. Waarom? Elk uitvoerbaar programma moet deel uitmaken van het 'main'-pakket.

Dit is de volgende regel in uw Go-bestand:

import "fmt"

De import instructie geeft toegang tot uw programma naar andere code in verschillende pakketten. In dit geval is fmt een standaardbibliotheekpakket. U kunt lezen over het fmt-pakket op de officiële Go-documentatiesite.

U hebt deze import instructie nodig omdat u een functie van dit pakket gebruikt om later in het programma een bericht naar het scherm af te drukken. U kunt zoveel import instructies opnemen als u wilt of nodig hebt in uw programma. Go is echter idiomatisch in dit verband. Als u een pakket importeert, maar geen bijbehorende functie uit het pakket gebruikt, wordt de app niet gecompileerd. Een geweldige functie van Visual Studio Code is dat ongebruikte importbewerkingen automatisch worden verwijderd in een programma wanneer u het bestand opslaat.

Heeft Visual Studio Code de import verwijderd toen u het bestand hebt opgeslagen? Probeer het bestand te bewerken zonder Visual Studio Code en probeer de app uit te voeren. Welke uitvoer ziet u nu?

Uitdaging: Nog een import toevoegen

Kunt u controleren wat u hebt geleerd over ongebruikte importbewerkingen?

  1. Herstel het Go-bestand naar de oorspronkelijke code.
  2. Voeg een andere importinstructie toe, zoals math of io.
  3. Sla het bestand op en voer het programma opnieuw uit in de Terminal.

  Wat gebeurt er dan? Verwijdert Visual Studio Code de ongebruikte import? Zo ja, wanneer wordt het verwijderd?

  1. Bewerk het Go-bestand opnieuw, maar gebruik Visual Studio Code niet.
  2. Sla het bestand op en voer het programma uit in een nieuwe prompt.

  Wat gebeurt er dan? Welke uitvoer ziet u nu?

 

Antwoord weergeven
Als u het Go-bestand in de IDE bewerkt en u het bestand opslaat, detecteert Visual Studio Code ongebruikte pakketten en verwijdert u de bijbehorende importinstructies. Wanneer u uw Go-bestand buiten Visual Studio Code bewerkt, mislukt de code. Er wordt een fout weergegeven, zoals: '#opdrachtregelargumenten .\main.go:5:2: geïmporteerd en niet gebruikt: 'wiskunde'.

Laten we eens kijken naar het codeblok in uw Go-bestand:

func main() {
   fmt.Println("Hello World!")
}

De func instructie is een gereserveerd woord dat wordt gebruikt om een functie te declareren. Deze eerste functie heet 'main' omdat dit het beginpunt van ons programma is. U kunt slechts één main() functie hebben over de package main functie (de functie die u hebt gedefinieerd in de eerste regel). In de main() functie hebt u de Println functie uit het fmt pakket aangeroepen. U hebt een sms-bericht verzonden dat u op het scherm wilt zien.

Er is meer te bespreken over functies en dat doen we in de volgende module.