Efektyvus derinimas ir kodo kokybė yra neatsiejamos programinės įrangos kūrimo sąvokos. „Visual Studio“ (VS) kodo derinimo funkciją daugiausia valdo failas launch.json. Šis failas leidžia kūrėjams konfigūruoti ir valdyti derinimo nustatymus pagal savo viziją.
Šis straipsnis padės jums atidaryti ir valdyti failą launch.json, kad būtų galima optimaliai derinti.
Atidaromas launch.json programoje „Visual Studio Code“.
Norėdami konfigūruoti ir valdyti VS kodo derinimo nustatymus, turėsite pasiekti failą launch.json. Šis failas atlieka lemiamą vaidmenį derinant tinkinimą.
kaip išsaugoti „Twitter“ gif
- Atidarykite „Visual Studio Code“.
- Paspauskite Ctrl + Shift + P, kad atidarytumėte komandų paletę.
- Komandų paletėje įveskite „Open launch.json“ ir paspauskite „Enter“. Tai turėtų atverti jums failą launch.json.
- Jei failas launch.json neatsidaro, patikrinkite, ar projekto šakniniame aplanke yra aplankas „.vscode“.
- Jei jo nėra, naudotojo aplanke sukurkite naują aplanką pavadinimu „.vscode“.
- Sukurkite naują „launch.json“ failą ir įdėkite jį į šį aplanką.
Failas launch.json bus paruoštas konfigūruoti jį įgalinus.
Launch.json struktūros apžvalga
Launch.json rodo „versijos“ ir „konfigūracijų“ skiltis. Skyrius „Konfigūracijos“ yra masyvas, kuriame yra skirtingų derinimo parinkčių, kurias naudosite derinimo schemai konfigūruoti.
Kiekvienas „konfigūracijų“ masyvo objektas reiškia derinimo scenarijų. Šie objektai turi savybių, kurios apibrėžia derinimo aplinką, pvz., kalbos, programos ir derinimo parametrus.
Kai kurios bendros ypatybės, su kuriomis susidursite vykdydami launch.json konfigūracijas, yra šios:
- „pavadinimas“ – skaitytojui patogus konfigūracijos pavadinimas, leidžiantis ją identifikuoti išskleidžiamajame meniu.
- „tipas“ – nurodo derinimo priemonės tipą (pvz., „mazgas“, „python“ arba „cppvsdbg“).
- „užklausa“ – nustato užklausos tipą: „paleisti“ (paleisti naują egzempliorių) arba „pridėti“ (pridedant derintuvą prie esamo proceso).
- „programa“ – failo, kurį norite derinti, kelias.
- „args“ – komandų eilutės argumentų masyvas, perduodamas programai derinimo metu.
- „preLaunchTask“ – užduotis, kurią reikia vykdyti prieš paleidžiant derintuvą.
Suprasdami launch.json failo struktūrą galite žinoti, kurias parinktis keisti, o kurias palikti, tinkinant derinimo aplinką.
Įvairių kalbų paleidimo nustatymų konfigūravimas
Paleidimo nustatymų konfigūravimo veiksmai gali šiek tiek skirtis priklausomai nuo kalbos. Čia pateikiami kelių populiarių kalbų veiksmai.
JavaScript ir TypeScript
- Sukurkite naują launch.json failą ir sukonfigūruokite ypatybę 'type' kaip 'mazgas' JavaScript arba 'pwa-node' TypeScript.
- Nustatykite ypatybę „užklausa“ į „paleisti“ arba „pridėti“.
- Turėtumėte nurodyti įvesties taško failą naudodami ypatybę 'programa'.
Python
- Įdiekite „Python“ interpretatorių ir „Visual Studio Code“ plėtinį.
- Naujame faile launch.json nustatykite ypatybę „type“ į „python“.
- Konfigūruokite ypatybę „užklausa“ kaip „paleisti“ arba „pridėti“.
- Nurodykite Python failą, kurį norite paleisti, naudodami ypatybę „program“.
- Gali reikėti papildomai nustatyti ypatybę „pythonPath“ į Python interpretatoriaus kelią, jei jis nėra numatytojoje vietoje.
C# ir .NET Core
- Įdiekite „Visual Studio Code“ C# plėtinį.
- Naujame faile launch.json nustatykite ypatybę „type“ į „coreclr“ .NET Core arba „clr“ .NET Framework.
- Konfigūruokite ypatybę „užklausa“ kaip „paleisti“ arba „pridėti“.
- Nurodykite įvesties taško failą naudodami ypatybę 'programa'.
- Jei reikia, nustatykite ypatybę „cwd“ į dabartinio projekto darbo katalogą.
Java
- Įdiekite „Java“ plėtinių paketą.
- Sukurkite naują launch.json failą ir ypatybę „type“ nustatykite į „java“.
- Konfigūruokite ypatybę „užklausa“ kaip „paleisti“ arba „pridėti“.
- Nurodykite pagrindinę klasę naudodami „mainClass“ ypatybę.
- Nustatykite ypatybę „projectName“ į savo „Java“ projekto pavadinimą.
- Sukonfigūruokite ypatybę „classpath“, kad įtrauktumėte „Java“ bibliotekas, kurias naudosite kurdami „Java“.
Derinimo konfigūracijos receptai
Šiame skyriuje aprašomi įvairūs derinimo konfigūracijos receptai.
Derinimo priemonės prijungimas prie veikiančio proceso
Norėdami pridėti derinimo priemonę prie veikiančio proceso:
- Nustatykite ypatybę „užklausa“ į „pridėti“.
- Pasirinkite proceso ID arba filtrą, kad rastumėte derinimo procesą.
Nuotolinis programų derinimas
Nuotoliniam programų derinimui:
- Naudokite „nuotolinio“ tipą.
- Norėdami užmegzti ryšį, pateikite pagrindinio kompiuterio adresą, prievadą ir galbūt autentifikavimo informaciją.
Derinimo vienetų testai ir testavimo rinkiniai
Derinant įrenginio testus ir testavimo rinkinius:
- Naudokite konfigūraciją, apimančią bandymo sistemą ir nustatymus, kad derintumėte vienetų testus ir bandymų rinkinius.
- Apibrėžkite testų rinkinį arba atskirus bandomuosius failus ypatybėje „program“ arba „args“, kad taikytų konkrečius testus.
Aplinkos kintamųjų perdavimas
Ypatybė „env“ faile launch.json gali perduoti aplinkos kintamuosius jūsų programai derinant. Ši ypatybė yra objektas, kuriame yra norimų nustatyti aplinkos kintamųjų raktų ir reikšmių poros.
Išplėstinis derinimas
Išnagrinėkime keletą pažangių derinimo metodų, skirtų vartotojams, norintiems išnaudoti šiek tiek daugiau derinimo failų galios.
Sąlyginiai lūžio taškai ir žurnalo taškai
Sąlyginiai lūžio taškai ir žurnalo taškai pagerina derinimą pristabdydami arba registruodami pranešimus tik tam tikromis sąlygomis. Norėdami juos naudoti:
- Dešiniuoju pelės mygtuku spustelėkite eilutės numerį, kuriame norite nustatyti lūžio tašką arba žurnalo tašką.
- Pasirinkite „Pridėti sąlyginį lūžio tašką“ arba „Pridėti žurnalo tašką“.
- Įveskite sąlygą arba pranešimą, kad suaktyvintumėte veiksmą.
Šaltinių žemėlapiai
Šaltinio žemėlapiai leidžia derinti kodą, kuris buvo transformuotas arba sumažintas.
- Norėdami naudoti šaltinio žemėlapius, savo launch.json konfigūracijoje nustatykite ypatybę „sourceMap“ į „true“.
- Įsitikinkite, kad jūsų kūrimo procesas generuoja šaltinio žemėlapius ir transformuotą kodą.
Išorinių derintuvų integravimas
Jei norite, į VS kodą galite integruoti išorinius derintuvus ir įrankius, tokius kaip gdb arba lldb.
- Įdiekite pasirinktą derinimo plėtinį.
- Sukonfigūruokite derintuvo nustatymus faile launch.json.
Kelių gijų programų derinimas
Derindami kelių gijų programas, galite valdyti atskirų gijų vykdymą.
- Norėdami tvarkyti gijas derinimo seanso metu, naudokite rodinį „gijos“ derinimo šoninėje juostoje.
- Galite pristabdyti, tęsti arba pereiti prie kiekvienos gijos kodo vykdymo atskirai.
Kelių tikslų derinimas
Sudėtinės paleidimo konfigūracijos leidžia derinti kelis objektus vienu metu. Jei norite pasinaudoti šia funkcija, pridėkite „junginių“ masyvą su konfigūracijos pavadinimais, kad galėtumėte sugrupuoti. Paleiskite juos pasirinkdami sudėtinės konfigūracijos pavadinimą iš Debug išskleidžiamojo meniu.
Konfigūruokite kelias paleidimo konfigūracijas, skirtas skirtingoms paslaugoms, funkcijoms ar galutiniams taškams, kad derintumėte mikropaslaugas ir programas be serverio. Naudokite sudėtines paleidimo konfigūracijas, kad paleistumėte šiuos taikinius kartu.
Jei naudojate kelių šaknų darbo sritis, kiekvienam aplankui sukurkite atskirus launch.json failus. Konfigūruokite kiekvieno šakninio aplanko paleidimo nustatymus atskirai, kad derintumėte projektus atskirai arba vienu metu naudodami junginius.
Įprastų launch.json problemų šalinimas
Kartais derinant dažnai atsiranda klaidų. Pažvelkime į keletą dažniausiai pasitaikančių problemų ir kaip jas pašalinti.
Schemos patvirtinimo klaidos
Schemos patvirtinimo klaidos atsiranda, kai faile launch.json yra netinkamų ypatybių arba verčių. Norėdami ištaisyti schemos klaidas:
- Peržiūrėkite klaidų pranešimus skydelyje Problemos.
- Atnaujinkite failą launch.json pagal informaciją iš klaidos pranešimo.
Derinimo gedimai
Neteisingi paleidimo nustatymai gali sukelti derinimo klaidų.
- Patikrinkite, ar paleidimo konfigūracijose nėra neteisingų failų kelių.
- Patikrinkite, ar trūksta derinimo priemonės arba užklausų tipai, arba jie netinkami.
- Jei reikia, atnaujinkite nustatymus.
Paleidimo konfigūracijos problemų diagnostika
Norėdami diagnozuoti paleidimo konfigūracijų problemas:
- Įgalinkite diagnostikos registravimą nustatydami ypatybę „trace“ į „verbose“.
- Peržiūrėkite sugeneruotus žurnalus Debug Console, kad nustatytumėte ir išspręstumėte visas problemas.
Patarimai dėl launch.json
Optimaliai naudokite launch.json vadovaudamiesi šiais patarimais:
- Naudokite prasmingus paleidimo konfigūracijų pavadinimus, kad jas būtų lengva atpažinti. Ši praktika padeda greitai rasti tinkamą konfigūraciją dirbant su keliais derinimo scenarijais.
- Bendrinkite paleidimo konfigūracijas su savo komanda įtraukdami failą launch.json į projekto versijos valdymo sistemą. Kiekvienas komandos narys gali pasiekti tas pačias derinimo konfigūracijas ir nustatymus.
- Versijų valdymo sistemos, pvz., Git, gali stebėti failo launch.json pakeitimus. Galite naudoti versijos valdymą, norėdami grįžti prie ankstesnių konfigūracijų ir bendradarbiauti su kitais komandos nariais, bendrindami su jais rekomenduojamus nustatymus.
- Įdiekite plėtinius, palaikančius konkrečias kalbas, derintuvus ar įrankius, atitinkančius projekto poreikius. Sukonfigūruokite failą launch.json, kad derinimo seansų metu būtų naudojami šie plėtiniai ir jų funkcijos.
Paleiskite į derinimo programą
Išnaudodami launch.json galią, galite koreguoti derinimo patirtį, kad ji geriausiai atitiktų jūsų kodavimo stilių. Tai pagerins jūsų kodo kokybę ir našumą.
Kaip dažnai turite konfigūruoti paleidimo nustatymus? Ar turite konfigūravimo patarimų? Pasidalykite savo patirtimi toliau pateiktame komentarų skyriuje.