Dela via


Handledning: Felsöka ett .NET-konsolprogram med hjälp av Visual Studio Code

I den här självstudien beskrivs de felsökningsverktyg som är tillgängliga i Visual Studio Code för arbete med .NET-appar.

I den här självstudien beskrivs de felsökningsverktyg som är tillgängliga i GitHub Codespaces för att arbeta med .NET-appar.

Förutsättningar

Den här handledningen är avsedd för konsolappen som du skapar i Skapa ett .NET-konsolprogram med Visual Studio Code.

Ange en brytpunkt

En brytpunkt avbryter tillfälligt körningen av programmet innan raden med brytpunkten körs.

  1. Starta Visual Studio Code.

  2. Öppna mappen för projektet som du skapade i Skapa ett .NET-konsolprogram med hjälp av Visual Studio Code.

  3. Öppna filen Program.cs .

  4. Ange en brytpunkt på raden som visar namn, datum och tid genom att klicka på vänstermarginalen i kodfönstret. Vänstermarginalen är till vänster om radnumren. Andra sätt att sätta en brytpunkt är genom att trycka på F9 eller välja Kör>Växla brytpunkt från menyn när raden med koden är markerad.

    Visual Studio Code anger den rad där brytpunkten anges genom att visa en röd punkt i vänstermarginalen.

    Brytpunkt satt

  1. Öppna ditt GitHub Codespace som du skapade i Skapa ett .NET-konsolprogram med hjälp av Visual Studio Code.

  2. Öppna filen HelloWorld.cs .

  3. Ange en brytpunkt på raden som visar namn, datum och tid genom att klicka på vänstermarginalen i kodfönstret. Vänstermarginalen är till vänster om radnumren. Du kan också ange en brytpunkt genom att trycka på F9 medan kodraden är markerad.

    Brytpunkts inställd

Börja felsöka

Felsökning och release är . NET:s inbyggda byggkonfigurationer. Du använder debugkonfigurationen för felsökning och releasekonfigurationen för den slutliga distributionen.

Som standard använder Visual Studio Code-startinställningarna konfigurationen Felsökningsversion, så du behöver inte ändra den innan du felsöker.

  1. Öppna felsökningsvyn genom att välja felsökningsikonen på menyn till vänster.

    Öppna fliken Felsökning i Visual Studio Code

  2. Välj Kör och Felsök. Om du tillfrågas väljer du C# och sedan C#: Starta startprojekt. Andra sätt att starta programmet i felsökningsläge är genom att trycka på F5 eller välja Kör>starta felsökning från menyn.

    Börja felsöka

  3. Om du uppmanas att välja Starta konfiguration väljer du C#: Felsök aktiv fil.

  4. Välj fliken Felsökningskonsol för att se uppmaningen "Vad är ditt namn?" som programmet visar innan du väntar på ett svar.

    Välj fliken Felsökningskonsol

  5. Ange en sträng i fönstret Felsökningskonsol som svar på uppmaningen om ett namn och tryck sedan på Retur.

    Programkörningen stoppas när den når brytpunkten och innan Console.WriteLine metoden körs. Avsnittet Locals i fönstret Variabler visar värdena för variabler som definieras i den metod som körs för tillfället.

    Brytpunkt nådd, visar lokala variabler

Som standard använder GitHub Codespaces konfigurationen för felsökningsversion, så du behöver inte ändra den innan du felsöker.

  1. Öppna felsökningsvyn genom att välja felsökningsikonen på menyn till vänster.

    Öppna fliken Felsökning i Visual Studio Code

  2. Välj Kör och Felsök. Om du tillfrågas väljer du C# som felsökare och väljer sedan C#: Felsöka aktiv fil som startkonfiguration.

  3. Välj fliken Felsökningskonsol för att se uppmaningen "Vad är ditt namn?" som programmet visar innan du väntar på ett svar.

  4. Ange en sträng i fönstret Felsökningskonsol som svar på uppmaningen om ett namn och tryck sedan på Retur.

    Programkörningen stoppas när den når brytpunkten och innan Console.WriteLine metoden körs. Avsnittet Locals i fönstret Variabler visar värdena för variabler som definieras i den metod som körs för tillfället.

    Brytpunkten nådd, visar lokala variabler

Använda felsökningskonsolen

Med fönstret Felsökningskonsol kan du interagera med det program som du felsöker. Du kan ändra värdet för variabler för att se hur det påverkar ditt program.

  1. Välj fliken Felsökningskonsol .

  2. Ange name = "Gracie" i kommandotolken längst ned i felsökningskonsolfönstret och tryck på Retur.

    Ändra variabelvärden

  3. Ange currentDate = DateTime.Parse("2026-01-28T20:54:00Z").ToUniversalTime() längst ned i felsökningskonsolfönstret och tryck på Retur.

    Fönstret Variabler visar de nya värdena för variablerna name och currentDate .

  4. Fortsätt programkörningen genom att välja knappen Fortsätt i verktygsfältet. Ett annat sätt att fortsätta är genom att trycka på F5.

    Fortsätt felsökningen

    Värdena som visas i konsolfönstret motsvarar de ändringar som du har gjort i felsökningskonsolen.

    Terminal som visar de angivna värdena

  5. Tryck på Retur för att avsluta programmet och sluta felsöka.

Ange en villkorsstyrd brytpunkt

Programmet visar strängen som användaren anger. Vad händer om användaren inte anger något? Du kan testa detta med en användbar felsökningsfunktion som kallas villkorlig brytpunkt.

  1. Högerklicka (Ctrl-klicka på macOS) på den röda punkt som representerar brytpunkten. I snabbmenyn väljer du Redigera brytpunkt för att öppna en dialogruta där du kan ange ett villkorsuttryck.

    Kontextmeny för brytpunkt

  2. Välj Expression i listrutan, ange följande villkorsuttryck och tryck på Retur.

    String.IsNullOrEmpty(name)
    

    Ange ett villkorsuttryck

    Varje gång brytpunkten nås anropar felsökningsprogrammet metoden, och det stoppar endast på denna rad om metodanropet returnerar String.IsNullOrEmpty(name).

    I stället för ett villkorsuttryck kan du ange ett antal träffar, vilket avbryter programkörningen innan en instruktion körs ett angivet antal gånger. Ett annat alternativ är att ange ett filtervillkor som avbryter programkörningen baserat på sådana attribut som trådidentifierare, processnamn eller trådnamn.

  3. Starta programmet med felsökning genom att trycka på F5.

  4. På fliken Felsökningskonsol trycker du på Retur när du uppmanas att ange ditt namn.

    Eftersom villkoret du angav (name är antingen null eller String.Empty) har uppfyllts stoppas programkörningen när den når brytpunkten och innan Console.WriteLine metoden körs.

    Fönstret Variabler visar att värdet för variabeln name är "", eller String.Empty.

  5. Bekräfta att värdet är en tom sträng genom att ange följande instruktion i felsökningskonsolens prompt och trycka på Retur. Resultatet är true.

    name == String.Empty
    
  6. Välj knappen Fortsätt i verktygsfältet för att fortsätta programkörningen.

  7. Tryck på Retur för att avsluta programmet och sluta felsöka.

  8. Rensa brytpunkten genom att klicka på punkten i kodfönstrets vänstermarginal. Andra sätt att rensa en brytpunkt är genom att trycka på F9 eller välja Kör > Växla Brytpunkt från menyn medan kodraden är markerad.

  9. Om du får en varning om att brytpunktsvillkoret kommer att gå förlorat väljer du Ta bort brytpunkt.

Stega igenom ett program

Med Visual Studio Code kan du också stega rad för rad genom ett program och övervaka dess körning. Vanligtvis anger du en brytpunkt och följer programflödet genom en liten del av programkoden. Eftersom det här programmet är litet kan du gå igenom hela programmet.

  1. Ange en brytpunkt på kodraden som visar uppmaningen "Vad är ditt namn?".

  2. Tryck på F5 för att börja felsöka.

    Visual Studio Code markerar brytpunktslinjen.

    Nu visar fönstret Variabler att matrisen args är tom och namecurrentDate har standardvärden.

  3. Välj Steg in i verktygsfältet Felsökning eller tryck på F11.

    Step-Into-knappen

    Visual Studio Code markerar nästa rad.

  4. Visual Studio Code kör Console.WriteLine för namnprompten och markerar nästa körningsrad. Nästa rad är Console.ReadLine för name. Fönstret Variabler är oförändrat och på fliken Terminal visas uppmaningen "Vad är ditt namn?".

  5. Välj Steg in i eller tryck på F11.

    Visual Studio Code markerar variabeltilldelningen name . Fönstret Variabler visar att name fortfarande är null.

  6. Svara på uppmaningen genom att ange en sträng på fliken Terminal och trycka på Retur.

    Fliken Felsökningskonsol kanske inte visar den sträng som du anger när du anger den, men Console.ReadLine metoden samlar in dina indata.

  7. Välj Steg in i eller tryck på F11.

    Visual Studio Code markerar variabeltilldelningen currentDate . Fönstret Variabler visar det värde som returneras av anropet till Console.ReadLine metoden. Fliken Terminal visar strängen som du angav i kommandotolken.

  8. Välj Steg in i eller tryck på F11.

    Fönstret Variabler visar värdet för variabeln currentDate efter tilldelningen DateTime.Now från egenskapen.

  9. Välj Steg in i eller tryck på F11.

    Visual Studio Code anropar Console.WriteLine(String, Object, Object) metoden. Konsolfönstret visar den formaterade strängen.

  10. Välj Steg ut eller tryck på Skift+F11.

    Step-Out-knappen

    Terminalen visar "Tryck på valfri tangent för att avsluta..."

  11. Tryck på valfri tangent för att avsluta programmet.

Använda Release-byggkonfiguration

När du har testat Debug-versionen av din applikation bör du också kompilera och testa Release-versionen. Versionsversionen innehåller kompilatoroptimeringar som kan påverka beteendet för ett program. Kompilatoroptimeringar som är utformade för att förbättra prestanda kan till exempel skapa konkurrensvillkor i flertrådade program.

Om du vill skapa och testa versionen av konsolprogrammet öppnar du terminalen och kör följande kommando:

dotnet run --configuration Release

Kör följande kommando i terminalen för att skapa och testa versionen av konsolprogrammet:

dotnet run --configuration Release HelloWorld.cs

Nästa steg

I den här handledningen använde du felsökningsverktygen i Visual Studio Code. I nästa handledning publicerar du en distribuerbar version av appen.