Ako otvoriť súbor launch.json v kóde VS

Efektívne ladenie a kvalita kódu sú neoddeliteľné pojmy vo vývoji softvéru. Funkcia ladenia kódu Visual Studio (VS) je riadená hlavne súborom launch.json. Tento súbor umožňuje vývojárom konfigurovať a spravovať nastavenia ladenia podľa ich vízie.

Tento článok vás prevedie otvorením a správou súboru launch.json pre optimálne ladenie.

Otvorenie súboru launch.json v kóde Visual Studio

Ak chcete nakonfigurovať a spravovať nastavenia ladenia kódu VS, budete potrebovať prístup k súboru launch.json. Tento súbor hrá kľúčovú úlohu pri prispôsobení ladenia.

Otvorte kód Visual Studio.
Stlačením Ctrl + Shift + P otvorte paletu príkazov.
Napíšte „Open launch.json“ na palete príkazov a stlačte „Enter“. Tým by sa mal otvoriť súbor launch.json.
Ak sa súbor launch.json neotvorí, skontrolujte, či v koreňovom priečinku vášho projektu existuje priečinok „.vscode“.
Ak neexistuje, vytvorte nový priečinok s názvom „.vscode“ v priečinku Používateľ.
Vytvorte nový súbor „launch.json“ a umiestnite ho do tohto priečinka.

Súbor launch.json bude pripravený na konfiguráciu po jeho povolení.

Prehľad štruktúry súboru Launch.json

Súbor launch.json zobrazuje sekcie „verzia“ a „konfigurácie“. Sekcia „konfigurácie“ je pole obsahujúce rôzne možnosti ladenia, ktoré použijete na konfiguráciu schémy ladenia.

Každý objekt v poli „configurations“ predstavuje scenár ladenia. Tieto objekty majú vlastnosti, ktoré definujú prostredie ladenia, ako napríklad nastavenia jazyka, programu a ladiaceho nástroja.

nie je možné použiť ponuku Štart Windows 10

Niektoré bežné vlastnosti, s ktorými sa stretnete v konfiguráciách launch.json, zahŕňajú:

„name“ – čitateľsky zrozumiteľný názov konfigurácie na identifikáciu v rozbaľovacej ponuke.
„type“ – Určuje typ debuggera (napríklad „node“, „python“ alebo „cppvsdbg“).
„požiadavka“ – Určuje typ požiadavky, buď „spustiť“ (na spustenie novej inštancie) alebo „pripojiť“ (pripojiť debugger k existujúcemu procesu).
„program“ – Cesta k súboru, ktorý chcete ladiť.
„args“ – pole argumentov príkazového riadka, ktoré sa majú odovzdať programu počas ladenia.
„preLaunchTask“ – Úloha, ktorá sa má spustiť pred spustením ladiaceho nástroja.

Pochopenie štruktúry súboru launch.json vám umožní vedieť, ktoré možnosti zmeniť a ktoré nechať tak, zatiaľ čo si prispôsobujete prostredie ladenia.

Konfigurácia nastavení spustenia pre rôzne jazyky

Kroky na konfiguráciu nastavení spustenia sa môžu mierne líšiť v závislosti od jazyka. Tu sú kroky pre niekoľko populárnych jazykov.

JavaScript a TypeScript

Vytvorte nový súbor launch.json a nakonfigurujte vlastnosť „type“ ako „node“ pre JavaScript alebo „pwa-node“ pre TypeScript.
Nastavte vlastnosť „request“ na „spustiť“ alebo „priložiť“.
Súbor vstupného bodu by ste mali zadať pomocou vlastnosti „program“.

Python

Nainštalujte interpret a rozšírenie Pythonu pre kód Visual Studio.
Nastavte vlastnosť „type“ na „python“ v novom súbore launch.json.
Vlastnosť „request“ nakonfigurujte ako „spustiť“ alebo „priložiť“.
Zadajte súbor Python, ktorý sa má spustiť, pomocou vlastnosti „program“.
Možno budete musieť dodatočne nastaviť vlastnosť „pythonPath“ na cestu interpreta Pythonu, ak sa nenachádza v predvolenom umiestnení.

C# a .NET Core

Nainštalujte rozšírenie C# pre kód Visual Studio.
V novom súbore launch.json nastavte vlastnosť „type“ na „coreclr“ pre .NET Core alebo „clr“ pre .NET Framework.
Vlastnosť „request“ nakonfigurujte ako „spustiť“ alebo „priložiť“.
Zadajte súbor vstupného bodu pomocou vlastnosti „program“.
V prípade potreby nastavte vlastnosť „cwd“ na pracovný adresár aktuálneho projektu.

Java

Nainštalujte balík Java Extension Pack.
Vytvorte nový súbor launch.json a nastavte vlastnosť „type“ na „java“.
Vlastnosť „request“ nakonfigurujte ako „spustiť“ alebo „priložiť“.
Zadajte hlavnú triedu pomocou vlastnosti „mainClass“.
Nastavte vlastnosť „projectName“ na názov vášho projektu Java.
Nakonfigurujte vlastnosť „classpath“ tak, aby zahŕňala knižnice Java, ktoré budete používať počas vývoja Java.

Recepty konfigurácie ladenia

Nasledujúca časť obsahuje rôzne recepty konfigurácie ladenia.

Pripojenie debuggera k spustenému procesu

Ak chcete pripojiť ladiaci program k spustenému procesu:

Nastavte vlastnosť „request“ na „attach“.
Vyberte ID procesu alebo filter, aby ste našli proces na ladenie.

Vzdialené ladenie aplikácií

Pre vzdialené ladenie aplikácií:

Použite „diaľkový“ typ.
Poskytnite adresu hostiteľa, port a prípadne aj overovacie informácie na vytvorenie spojenia.

Ladenie testov jednotiek a testovacích sád

Pri ladení testov jednotiek a testovacích sád:

Na ladenie testov jednotiek a testovacích sád použite konfiguráciu, ktorá zahŕňa testovací rámec a nastavenia.
Definujte sadu testov alebo jednotlivé testovacie súbory vo vlastnosti „program“ alebo „args“ na zacielenie na konkrétne testy.

Odovzdávanie premenných prostredia

Vlastnosť „env“ v súbore launch.json môže počas ladenia odovzdať premenné prostredia vašej aplikácii. Táto vlastnosť je objekt, ktorý obsahuje páry kľúč – hodnota pre premenné prostredia, ktoré chcete nastaviť.

Pokročilé ladenie

Poďme preskúmať niektoré pokročilé techniky ladenia pre používateľov, ktorí chcú z ladiacich súborov vyžmýkať trochu viac energie.

Podmienené hraničné body a logpointy

Podmienené body prerušenia a logpointy zlepšujú ladenie pozastavením alebo protokolovaním správ iba za špecifických podmienok. Ak ich chcete použiť:

Kliknite pravým tlačidlom myši na číslo riadku, kde chcete nastaviť bod prerušenia alebo bod protokolu.
Vyberte možnosť „Pridať podmienený bod prerušenia“ alebo „Pridať bod protokolu“.
Zadajte podmienku alebo správu na spustenie akcie.

Mapy zdrojov

Zdrojové mapy vám umožňujú ladiť kód, ktorý bol transformovaný alebo miniifikovaný.

Ak chcete použiť zdrojové mapy, v konfigurácii súboru launch.json nastavte vlastnosť „sourceMap“ na hodnotu „true“.
Uistite sa, že váš proces zostavovania generuje zdrojové mapy a transformovaný kód.

Integrácia externých debuggerov

Ak chcete, môžete do kódu VS integrovať externé debuggery a nástroje, ako napríklad gdb alebo lldb.

Nainštalujte vybrané rozšírenie ladiaceho nástroja.
Nakonfigurujte nastavenia ladiaceho nástroja v súbore launch.json.

Ladenie viacvláknových aplikácií

Pri ladení viacvláknových aplikácií môžete ovládať vykonávanie jednotlivých vlákien.

Na spravovanie vlákien počas relácie ladenia použite zobrazenie „vlákna“ na bočnom paneli ladenia.
Spúšťanie kódu môžete pozastaviť, obnoviť alebo krokovať v každom vlákne samostatne.

Ladenie viacerých cieľov

Konfigurácie zloženého spustenia umožňujú ladenie viacerých cieľov súčasne. Ak chcete využiť túto funkciu, pridajte pole „compounds“ s názvami konfigurácií na zoskupenie. Spustite ich výberom názvu zloženej konfigurácie z rozbaľovacej ponuky Debug.

Nakonfigurujte viacero konfigurácií spúšťania zameraných na rôzne služby, funkcie alebo koncové body na ladenie mikroslužieb a aplikácií bez servera. Na spoločné spustenie týchto cieľov použite konfigurácie zloženého spúšťania.

V prípade pracovných priestorov s viacerými koreňmi vytvorte samostatné súbory launch.json pre každý priečinok. Nakonfigurujte nastavenia spustenia pre každý koreňový priečinok jednotlivo, aby ste ladili projekty samostatne alebo súčasne pomocou zlúčenín.

Riešenie bežných problémov so súborom launch.json

Niekedy je ladenie náchylné na vlastnú sadu chýb. Pozrime sa na niekoľko bežných problémov a na ich riešenie.

Chyby overenia schémy

Chyby overenia schémy sa vyskytujú, keď má súbor launch.json neplatné vlastnosti alebo hodnoty. Ak chcete opraviť chyby schémy:

Skontrolujte chybové hlásenia na paneli Problémy.
Aktualizujte súbor launch.json podľa informácií z chybového hlásenia.

Zlyhania ladenia

Nesprávne nastavenia spustenia môžu spôsobiť zlyhanie ladenia.

Skontrolujte, či v konfiguráciách spustenia nie sú nesprávne cesty k súborom.
Overte chýbajúci alebo nesprávny debugger alebo typy požiadaviek.
Aktualizujte nastavenia podľa potreby.

Diagnostika problémov s konfiguráciou spustenia

Diagnostika problémov s konfiguráciami spúšťania:

Povoľte diagnostické protokolovanie nastavením vlastnosti „trace“ na „verbose“.
Skontrolujte vygenerované protokoly v konzole ladenia, aby ste identifikovali a opravili všetky problémy.

Tipy pre súbor launch.json

Použite launch.json optimálne s týmito tipmi:

Použite zmysluplné názvy pre svoje spúšťacie konfigurácie, aby boli ľahko identifikovateľné. Tento postup vám pomôže rýchlo nájsť vhodnú konfiguráciu pri práci s viacerými scenármi ladenia.
Zdieľajte konfigurácie spustenia so svojím tímom zahrnutím súboru launch.json do systému správy verzií vášho projektu. Každý člen tímu má prístup k rovnakým konfiguráciám a nastaveniam ladenia.
Systémy na správu verzií, ako je Git, môžu sledovať zmeny vo vašom súbore launch.json. Pomocou správy verzií sa môžete vrátiť k predchádzajúcim konfiguráciám a spolupracovať s ostatnými členmi tímu zdieľaním odporúčaných nastavení s nimi.
Nainštalujte rozšírenia, ktoré podporujú konkrétne jazyky, debuggery alebo nástroje, ktoré vyhovujú požiadavkám projektu. Nakonfigurujte súbor launch.json na používanie týchto rozšírení a ich funkcií počas relácií ladenia.

Spustiť do ladenia

Využitím sily launch.json si môžete prispôsobiť svoje ladenie tak, aby čo najlepšie zodpovedalo vášmu štýlu kódovania. Tým sa zvýši kvalita a výkon vášho kódu.