camelCase, snake_case, kebab-case: a fejlesztői elnevezési útmutató
Amikor változókat, függvényeket, osztályokat vagy URL-eket nevez el, a választott formátum számít. A különböző nyelvek és kontextusok eltérő konvenciókkal rendelkeznek: a JavaScript a camelCase-t, a Python a snake_case-t, a CSS-tulajdonságok a kebab-case-t, a konfigurációs állandók pedig a CONSTANT_CASE-t használják. Mindegyik megértése és azok közötti konvertálás gyakorlati készség, amely konzisztens és olvasható kódot biztosít.
camelCase: a JavaScript szabvány
camelCase kisbetűvel kezdődik, és minden következő szó első betűjét nagybetűvel írja, elválasztó nélkül. A JavaScript változói és függvénynevei a következő mintát követik: getUserById, calculateTotalPrice, handleSubmitClick. A legtöbb JSON-kulcs megegyezés szerint camelCase.
A név a nagybetűk által létrehozott "púpokból" származik. Kompakt, olvasható és a JavaScript, a TypeScript, a Java és a C# de facto szabványa. Ha a szöveget camelCase-be kell konvertálnia – akár kódgenerátort épít, akár változóneveket szabványosít – tok átalakító egy pasztában kezeli.
snake_case: Python és adatbázisok
A snake_case a szavakat aláhúzásjelekkel egyesíti, és minden betűt kisbetűvel ír: get_user_by_id, calculate_total_price, handle_submit_click. A Python fejlesztők ezt használják változó- és függvénynevekhez, a PEP 8 stílusirányelvei szerint. Az SQL oszlop- és táblanevek is gyakran használják a snake_case-t, ahogy a legtöbb rendszerben a környezeti változók is.
A snake_case még csupa nagybetűs formában is olvasható (DATABASE_PASSWORD, MAX_RETRY_COUNT), ezért a CONSTANT_CASE – nagybetűs snake_case – a konfigurációs állandók és végső változók univerzális konvenciója minden nyelven.
kebab-case: URL-ek és CSS
A kebab-case a szavakat kötőjelekkel kapcsolja össze, és minden kisbetűt használ: get-user-by-id, calculate-total-price. Ez mindenhol látható az URL-ekben – a slugs cikkben, a termékoldalakon, az útvonalnevekben –, mert a kötőjelek barátságosak a keresőmotorok számára, és kevésbé valószínű, hogy az elemzők félreértelmezik őket, mint az aláhúzás. A CSS-osztálynevek és az egyéni HTML-attribútumok megegyezés szerint a kebab-kisbetűt is használják.
Az URL-biztonságú azonosítók vagy slug-szerű nevek egyszerű szövegből való építése az egyik legpraktikusabb felhasználási mód. A slug generátor átalakítja a kifejezéseket URL-kész kebabdoboz karakterláncokká, miközben lehúzza az írásjeleket és az ékezeteseket.
PascalCase: osztályok és típusok
A PascalCase (vagy UpperCamelCase) az első betűt nagybetűvel írja: GetUserById, CalculateTotalPrice. Ez az osztálynevek, a típusdefiníciók és a TypeScript, C#, Java és React összetevőinek konvenciója. Ha objektumorientált nyelvekkel vagy komponens-keretrendszerekkel dolgozik, ez az, amihez nyúl.
Konvertálás a formátumok között
Az egyik konvencióból a másikba való átállás két lépést igényel: először hasított az azonosítót külön szavakra, majd csatlakozzon újra a célelválasztóval és a burkolattal. Az eszközök itt egyszerűsítik a folyamatot.
Ha rendelkezik camelCase azonosítóval, és meg kell értenie annak részeit – esetleg át kell nevezni vagy egy snake_case verzióval kell egyeztetni –, hasított teveTok az eszköz szétszedi: getUserById válik get User By Id. A szavak elválasztása után a tok átalakító Bármilyen konvencióban újraformázhatja őket. A fejlesztők akkor is használják ezeket az eszközöket, amikor a kódot átlépik a nyelvi határokon, vagy amikor az API specifikációi és a belső változónevek között fordítanak le.
Mikor kell használni az egyes egyezményeket
A helyes választás a kontextustól függ, nem a preferenciától. A JavaScript és a JSON a camelCase-t használja. A Python, SQL és környezeti változók a snake_case-t használják. Az URL-ek és a CSS a kebab-case-t használják. A típus- és osztálynevek PascalCase-t használnak. A konfigurációs állandók a CONSTANT_CASE-t használják minden nyelven. Ezen konvenciók betartásával a kódja azonnal felismerhető mindenki számára, aki ismeri az ökoszisztémát.
A konzisztencia fontosabb, mint a konkrét konvenció – ha ugyanabban a fájlban vagy projektben keveri a formátumokat, az olvasóknak kontextust kell váltaniuk, és könnyebbé válnak a hibák. Az azonosítók konvertálására és felosztására szolgáló eszközök segítségével konzisztens maradhat, amikor több nyelven dolgozik, vagy kódot helyez át a projektek között.