Druckbare Version
Hallo meine Lieben :),
in letzter Zeit habe ich vermehrt Quellcode gelesen und dabei bemerkt,
dass in den meisten Fällen der Stil ziemlich Schauderhaft ist.
Deshalb werde ich in diesem Thread versuchen, Tipps zum stilvollen Coding
zu sammeln.
Bitte helft mit und schickt mir eure Tipps und Tricks per PN.
Jetzt geht es aber los:
Tipps und Tricks zum richtigen Coden
Spoiler:Code sinnvoll formatieren! (klick)
Spoiler:Variblennamen vergeben! (klick)
Spoiler:Kommentare benutzen! (klick)
Bevor ich mir von jemandem vorschreiben lasse, wie ich meinen Stil zu gestalten habe, höre ich lieber auf.
soll ja auch 1-line coder geben die zurechtkommen.
Heisst aber nicht, dass dieser Code dann auch leicht lesbar ist.
Außerdem ist das hier ein Leitfaden und kein Regelwerk.
Wer schreibt dir denn hier bitte vor wie du zu coden hast?Zitat:
Zitat von makkurona
Es sollen lediglich Tipps sein die dazu beitragen,
dass auch noch andere Entwickler durch deinen Code durchsteigen
und nicht irgend ein "Wollknäuel" vor sich haben....
Ich wollte es nur anmerken.
Ich persönlich kommentiere und rücke ein. Das Variablennamen ersichtlich sein sollten ist eigentlich klar. So wie man es auch machen sollte. Aber ich finde, dass jeder seinen eigenen Stil finden sollte.
In Multientwicklerprojekten, ist das wieder etwas anderes, dann sollte man gewisse Grundregeln festmachen, aber ansonsten... Naja. Ich weiß nicht. *zwinker*
Wie gesagt, es sind nur Tipps...
Keine Regeln, solche aufzustellen wär unverschämt.
Diese Richtlinien haben mir sehr geholfen (und LuaEdit, habe vorher im Windows Editor gecodet)
Auf der anderen seite wird sowas natürlisch absichtlich gemacht denn man soll den code ja nicht immer nachvollziehen können. Nicht jeder Depp sollte sich daraus einen Vorteil ziehen, schon garnich wenn alles open source ist (ok widerspruch in sich aber ***** =).
Den Stimm ich voll zu ;)Zitat:
Zitat von Scarecrow
Ich Rücke zwar auch ein,aber ich schreibe extra keine Kommentare,wenn doch, dann nur in einer seperaten TextFile,die ich nicht mitveröffentlichen werde.
Wenn man sich doch dieses mit Script-Kiddys überflutete Gmorg anschaut,versucht man schließlich recht häufig den Code so unverständlich wie möglich zu machen.
(Siehe NUKE_V10,NUKE_V2231,NUKE_SUPER_V152_FIX etc)
Dies sind nur Empfehlungen.Zitat:
Zitat von makkurona
Ich habe schon allzu saumößigen code gesehen.
Man hat förmlich erkannt, dass code-schnippsel aus anderen Projekten einfach per copy&paste kopiert wurde, ohne ihn mal an das layout anzupassen.
Mal ehrlich, findest du
schön? Da hat "Dark Nova Clan" richtig geschlampt (kommt aus VU-Mod). Einzüge, wo keine reingehören sowie fehlende. Ineffiziente coding-weise (Mehrfach-aufruf von funktionen anstatt nur einmal und den wert in einer lokalen variable speichern).
Dazu gibt es noch schlimmeren code, welcher leerzeichen anstatt tabs benutzt bzw beiders durcheinander.
Und was ich am schlimmsten finde, sind leerzeichen zwischen funktionen-argumenten bzw. dessen inkonsistente verwendung.
Wie vom code oben:
Wieso wird bei der ersten funktion am anfang und ende ein leerzeichen eingefügt, nicht aber bei der nächsten? Macht die sache "unschön".
Ok, es sind hobby programmierer. Aber selbst als hobby-programmier sollte man erstmal vernünftig coden lernen bevor man etwas anfängt. Sonst wird das Programm extrem unleserlich oder schlechter zu debuggen (was der Hauptgrund ist, wieso man leserlich coden sollte!) und kann im schlimmsten Fall einfach den Rechner einfrieren.
Jeder, der dies nicht erkennt codet grob fahrlässig und sollte lieber die Finger davon lassen.
@BennyG
Ich notiere meine sachen auch nicht.
Was ich wichtig finde das man zumindest in einem skript alles einheitlich macht, nicht so wie bei aVoN's letztem Beispiel was eindeutig nach copy'n'paste aussieht.
Mfg,
RP-01
Ich habe mich mal dazu entschieden das ganze anzupinnen,
da es doch schon eine wichtige Rolle beim Scripten spielt ;)
*niederknie*
Vielen Dank, Pac!
MfG kartoffel
Hat mir echt geholfen jetzte sieht mein Code schonmal übersichtlicher
aus *gg*
Das freut mich sehr.
MfG kartoffel
Um längere Funktion auszuklammern, sodass es auch im Notepad übersichtlicher ist:
Da finde ich
wesentlich besser...
Ich habs nur geschrieben, da diese Methode vom Notpad auch grün makiert wird.
Die andere hier wird (bei mir zumindest) im Notepad nicht grün makiert.
Deswegen benutz ich das auch öfter wenn ich mal alternative Funktionen testen will ^.^Zitat:
Zitat von RP-01
Ich ergänze das sofort, danke für die Vorschläge.
Versucht mal das:Zitat:
Zitat von RP-01
http://sourceforge.net/project/showf...kage_id=265782
bzw.:
http://code.google.com/p/npp-gmod-lua/