AI WORLD HQHasznos magyarázó megjegyzések a kódodhoz a GitHub Copilottal – kezdőknek
Barátságos, lépésről lépésre haladó útmutató, amely megmutatja, hogyan kérheted meg a GitHub Copilotot, hogy érthető magyar nyelvű megjegyzéseket írjon a kódod bármely sora fölé
Röviden: Néhány perc alatt megtanulhatod, hogyan kérd meg a GitHub Copilotot, hogy közérthető megjegyzéseket írjon a kódod bármely sora fölé – akár soha nem nyitottál még kódszerkesztőt.
Az útmutató végére már bármely kódsort meg tudsz jelölni úgy, hogy a GitHub Copilot érthető, hétköznapi nyelven megmagyarázza – akkor is, ha eddig soha nem nyitottál meg kódszerkesztőt. Ez a leírás teljesen kezdőknek szól, akik szeretnék érthetőbbé tenni a saját scriptjeiket maguk és mások számára.
💡 Tipp: kattints egy lépés számára, ha kész vagy — zöld pipa jelenik meg, és a böngésződ megjegyzi, meddig jutottál.
Mielőtt belevágnál
- Egy ingyenes GitHub-fiók (ezzel lépsz be a VS Code-ba).
- A Visual Studio Code telepítve a gépedre (Windows, macOS vagy Linux).
- Bekapcsolt GitHub Copilot – az ingyenes, egyéni fejlesztői csomag is tökéletes, vagy fizetős előfizetésre is válthatsz, ha többször használnád.
- Egy egyszerű kód- vagy szövegfájl, amivel szívesen kísérletezel.
- Körülbelül 10 perc nyugalom, hogy ne zavarjanak meg közben.
Töltsd le és telepítsd a Visual Studio Code-ot
Nyisd meg a code.visualstudio.com oldalt bármilyen böngészőben; egy nagy gombot fogsz látni, amelyen általában ez áll: „Download for Windows", „Download for macOS" vagy „Download for Linux". Kattints erre a gombra, majd nyisd meg a letöltések mappába érkezett telepítőt (a fájlnév .exe, .dmg, .deb vagy .rpm végződésű). A telepítő végigvezet pár képernyőn – kattints rendre a „Next" gombra, fogadd el a licencet, majd nyomj az „Install" gombra. Amikor a telepítés befejeződött, a VS Code elindul: egy vékony bal oldalsávval és egy üres középső szerkesztőfelülettel fogad. Ha a gomb felirata nem pont ez, keresd az „Other platforms" vagy a „Get VS Code for …" linket. Akkor jártál sikerrel, ha a VS Code ikonja megjelenik az asztalon vagy az alkalmazásmappádban, és a program egy üres szerkesztőablakkal indul el.
Jelentkezz be a GitHubba a VS Code-ból
A VS Code megnyitása után pillants a bal alsó sarokra; egy kis sziluett ikont látsz – ez az Accounts gomb (gondolhatsz rá úgy, mint egy ajtóra, amelyen át a VS Code találkozik az online személyazonosságoddal). Kattints rá; egy kis panel csúszik fel, amelyen a „Sign in with GitHub" opciót kínálja fel. Válaszd ezt; az alapértelmezett böngésződ megnyílik, és a szokásos GitHub-bejelentkezési ablak jelenik meg. Miután jóváhagytad a bejelentkezést, a panel eltűnik, és egy kis avatár vagy a monogramod jelenik meg a sziluett helyén. Ha nem látod a sziluettet, a menüsorból válaszd a View → Command Palette opciót, írd be, hogy „Sign in", és válaszd a GitHubhoz kapcsolódó lehetőséget. Akkor jártál sikerrel, ha a GitHub-felhasználóneved vagy az avatarod megjelenik a VS Code bal alsó sarkában.
Telepítsd a GitHub Copilot bővítményt
A bal oldalsávon keresd azt az ikont, amely négy kis négyzetre emlékeztet, kirakószerűen elrendezve – ez nyitja meg az Extensions nézetet (képzelj egy mini alkalmazásboltot, ami be van építve a VS Code-ba). Kattints az ikonra; megjelenik egy panel, felül egy keresősávval. Írd be a keresőbe, hogy GitHub Copilot. Az első találat a hivatalos Copilot bővítmény, mellette egy Install gombbal. Kattints az Install gombra; a VS Code letölti a bővítményt, és automatikusan engedélyezi is. Ha a folyamat befejeződött, egy új Copilot-embléma (általában egy stilizált csevegőbuborék) jelenik meg az aktivitássávon – ez a vékony függőleges csík a legszélén. Ha nem találod a négyzet ikont, a felső menüből is megnyithatod: View → Extensions. Akkor jártál sikerrel, ha a bővítmények listájában a GitHub Copilot „Enabled" állapotban látható, és a Copilot ikonja megjelenik az aktivitássávon.
Nyiss meg egy kódfájlt a szerkesztőben
Kattints a bal oldalsáv első ikonjára – két egymásra helyezett lapra emlékekeztet, és az Explorert jelenti (gondolhatsz rá úgy, mint egy mappaböngészőre). Az Explorer panelen keresd meg azt a mappát, amelyben van egy fájl, például example.js vagy notes.txt. Egy kattintással jelöld ki a fájlt, majd dupla kattintással nyisd meg; a fájl tartalma megjelenik a középső szerkesztőfelületen, a bal oldalon pedig egy sorszámoszlop tűnik fel. (A függvény nem más, mint elnevezett utasítások egy csoportja, mint egy receptkártya, a megjegyzés pedig egy jegyzet az emberi olvasónak, amelyet a számítógép csendben figyelmen kívül hagy.) Ha az Explorer nem látható, nyomd meg a Ctrl+Shift+E billentyűkombinációt (macOS-en: Cmd+Shift+E). Akkor jártál sikerrel, ha a fájl szövege megjelenik a szerkesztőben, és a sorszámok a bal szélén sorban futnak lefelé.
Kérd meg a GitHub Copilotot, hogy javasoljon megjegyzést egy kódsor fölé
Állítsd a kurzort közvetlenül annak a sornak a fölé, amelyet meg szeretnél magyaráztatni. Írd be a // jelet, utána pedig egy rövid utasítást, például: Explain what this line does. Sok esetben a GitHub Copilot egy halvány, szürke ghost text (szellemszöveg) javaslatot mutat közvetlenül a gépelés után – ez a Copilot soron belüli automatikus kiegészítője. Ha megjelenik a szellemszöveg, nyomj Tabot, hogy valódi megjegyzéssé váljon; nyomj Escape-et, ha el szeretnéd vetni és más prompttal próbálkoznál.
Ha nem jelenik meg ghost text, annak az lehet az oka, hogy túl rövid az utasítás, vagy a bővítménynek kell egy kis idő a betöltéshez. Ilyenkor a beépített parancsot is használhatod tartalékként: nyisd meg a Command Palette-et (Ctrl+Shift+P / Cmd+Shift+P), és futtasd a „GitHub Copilot: Explain" parancsot (a pontos név kicsit eltérhet). A Copilot ekkor a kijelölt sor alapján szúr be egy megjegyzést.
Akkor jártál sikerrel, ha a célsor fölött megjelenik egy érthető megjegyzés, amely közérthető nyelven összegzi a sor célját.
Nézd át, szerkeszd és mentsd el a javaslatot
Olvasd fel hangosan az újonnan beszúrt megjegyzést; ha pontosan leírja a kódot, kész is vagy. Ha a megfogalmazás nem az igazi, egyszerűen kattints a megjegyzést tartalmazó sorra, és gépeld át – a Copilot nem tanul ezekből a javításokból, úgyhogy a kézi finomítás teljesen normális. Végül mentsd el a fájlt a Ctrl+S billentyűkombinációval (macOS-en: Cmd+S); a fülön a fájlnév melletti pötty eltűnik, ami azt jelzi, hogy a fájl mentve van. Ha a megjegyzés még nem elég érthető, menj vissza az 5. lépéshez, és fogalmazd át a promptot (például: Summarise the tax‑calculation step in plain English).
- Egész kódblokkot írsz be rövid prompt helyett. A GitHub Copilot rövid utasításokkal működik a legjobban, például:
// Explain this step. Megoldás: tartsd 10 szó alatt az indítósort. - Az Escape-et nyomod meg a Tab helyett, mielőtt elfogadnád a szellemszöveget. A szürke javaslat maga a kívánt eredmény; az Escape elveti. Megoldás: nyomj Tabot a javaslat elfogadásához, és utána szerkeszd, ha kell.
- Azt várod, hogy a Copilot elsőre megért nagyon összetett logikát. Hosszabb vagy kétértelmű kódnál gyakran csak homályos megjegyzések születnek. Megoldás: adj több kontextust a promptodhoz, vagy bontsd kisebb részekre a kódot, és egyszerre csak egy megjegyzést kérj.
Mit jelent ez számodra
- A hétköznapokban: gyorsan adhatsz önmagyarázó jegyzeteket a saját, bemásolt scriptjeidhez, így amikor legközelebb megnyitod a fájlt, emlékezni fogsz, mit csinál egy-egy sor.
- A munkádban vagy a cégnél: a csapatok a Copilot által generált megjegyzésekkel gördülékenyebbé tehetik az átadásokat, mert a kódot bárki könnyebben olvassa, aki később csatlakozik a projekthez – ehhez nem kell külön dokumentációs kört futtatni.
- Ha most ismerkedsz vele: nyiss meg egy apró saját fájlt, állítsd a kurzort egy üres sorra, írd be, hogy
// Explain what this line does, és figyeld, ahogy a GitHub Copilot másodpercek alatt barátságos megjegyzéssé alakítja.
Próbáld ki most
Nyiss meg egy tetszőleges kicsi kód- vagy szövegfájlt, állítsd a kurzort egy üres sorra egy általad ismert sor fölé, írd be, hogy // Explain what this line does, nyomj Tabot, amikor megjelenik a szellemszöveg (vagy használd a „GitHub Copilot: Explain" parancsot, ha nem jelenik meg), majd mentsd el a fájlt. Két percen belül a szerkesztőben lesz az első, Copilottal írt megjegyzésed.
❓ Gyors kérdések
Mennyi időt vesz igénybe?
Kb. 6 perc — az útmutató 6 lépésből áll, és mindegyiket ki tudod pipálni, ahogy haladsz.
Milyen eszköz kell hozzá?
Ez az útmutató a(z) GitHub Copilot eszközt használja — de a módszer nagyon hasonlóan működik más AI-asszisztensekben is.
Milyen hibákat kerüljek el?
- Egész kódblokkot írsz be rövid prompt helyett. A GitHub Copilot rövid utasításokkal működik a legjobban, például:
// Explain this step. Megoldás: tartsd 10 szó alatt az indítósort. - Az Escape-et nyomod meg a Tab helyett, mielőtt elfogadnád a szellemszöveget. A szürke javaslat maga a kívánt eredmény; az Escape elveti. Megoldás: nyomj Tabot a javaslat elfogadásához, és utána szerkeszd, ha kell.
- Azt várod, hogy a Copilot elsőre megért nagyon összetett logikát. Hosszabb vagy kétértelmű kódnál gyakran csak homályos megjegyzések születnek. Megoldás: adj több kontextust a promptodhoz, vagy bontsd kisebb részekre a kódot, és egyszerre csak egy megjegyzést kérj.
Olvass tovább
✦ Az AI World HQ AI-szerkesztőségének eredeti, lépésről lépésre útmutatója. Közérthetően írva, pontosságra ellenőrizve.
← Vissza a hírekhez