Fautuaga mo le Tusiaina o Tulafono e Mafai ona Tausia
O le tusiaina o polokalame faakomepiuta e lē na o le fa'agaoioia o se polokalame. I le fa'atinoina, o se vaega tele o le taimi e atiina ae ai polokalame faakomepiuta e fa'aalu i le faitauina, fa'aleleia, ma le atiina ae o polokalame faakomepiuta o lo'o iai—pe o lau lava polokalame faakomepiuta pe o se polokalame a se isi tagata. O le mea lea, o le mafai ona tusia polokalame faakomepiuta e mafai ona tausia o se tomai taua tele mo so'o se polokalame faakomepiuta. O polokalame faakomepiuta e mafai ona tausia e fa'aitiitia ai tau o tausiga, fa'avavevaveina ai fa'aopoopoga o foliga, fa'aitiitia ai mea sese, ma fa'aleleia atili ai le galulue fa'atasi a le 'au. O nisi nei o fautuaga aoga mo le tusiaina o polokalame faakomepiuta mama, manino, ma tumau.
1. Fa'amuamua le faigofie ona faitau nai lo le "poto"
O le code e "poto" tele e masani ona faigata ona malamalama i ai. Mo se faʻataʻitaʻiga, o le tusiaina o se laina code e matua puʻupuʻu lava e foliga matagofie, ae e mafai ona fenumiai pe a toe faitauina. Filifili se fofo manino, tusa lava pe umi teisi. O le faigofie ona faitauina o se tupe teufaafaigaluega: e mafai ona e naʻo le tasi le taimi e te tusia ai le code, ae o le a e faitauina i le tele o taimi.
Mo se faʻataʻitaʻiga, nai lo le faʻapipiʻiina o le tele o galuega faatino i totonu o se faʻaaliga e tasi, vaevae ia galuega faatino i ni laʻasaga e iai igoa fesuiaʻi taua. E fesoasoani lea i le tagata faitau e malamalama ai i le faʻamoemoega o le polokalama e aunoa ma le tau mateina.
2. Faaaoga igoa manino ma tutusa
O igoa o fesuia'iga, galuega faatino, ma vasega o le "laina muamua lea o pepa aloaia" mo lau code. O igoa lelei e tatau ona fa'amatalaina ai a latou matafaioi po'o le fa'amoemoega, ae le na'o le fa'atulagaga o a latou fa'amatalaga. Mo se fa'ata'ita'iga, o le `userList` e sili atu ona aoga nai lo le `ul`, ma le `calculateTotalPrice()` e sili atu ona manino nai lo le `ctp()`.
I le fa’aopoopoga i le manino, e tatau fo’i ona tutusa le fa’aigoaina o igoa. Afai e te fa’aaogaina le camelCase mo fesuia’iga, ia pipi’i i ai i lau galuega atoa. Mo vasega, fa’aaoga le PascalCase pe afai o le gagana lea e te fiafia i ai. O le tutusa e fa’atutusa ai le foliga o le code ma fa’aitiitia ai le mamafa o le mafaufau pe a faitau.
3. Fa'aaoga le mataupu faavae o le "Tiutetauave e Tasi"
O se tasi o mafuaʻaga autū o le faigata ona tausia o le code o galuega faatino poʻo vasega e tele naua mea e fai. O le Mataupu Faavae o le Tiutetauave e Tasi e fautua mai ai e tatau ona naʻo le tasi le tiutetauave autū o se iunite o le code. O se galuega faatino e umi tele e masani lava o se faailoga lea e manaʻomia ona vaevaeina.
Mo se faʻataʻitaʻiga, o se galuega faatino "faʻagasologa o le siakiina" e faʻamaonia ai le ulufale mai, fuafua tau, faʻafesoʻotaʻi se auala e totogi ai, ma lafo imeli o le a faigata ona faʻataʻitaʻiina ma faigata ona suia. I le vaevaeina i ni galuega faatino eseese (faʻamaoniga, fuafuaina, totogi, faʻasilasilaga), e mafai ona e faia ni suiga i le tasi vaega e aunoa ma le solia o isi.
4. Aloese mai le toe faia faalua (MĀGO), ae aua le soona fai.
O le DRY (Aua le Toe Fai Oe Lava) o se mataupu faavae taua: afai e te kopiina le poloka lava e tasi o le code i ni nai taimi, o se suiga laitiiti o le a manaʻomia ai ona e faasaʻoina mea uma. E faigofie ona sese lenei mea. O le fofo o le aveeseina lea o le logic faifai pea i totonu o se function po o se module.
Ae ui i lea, e taua le manatua o le aloese mai le soona faaluaina e mafai foi ona faaleagaina ai le faigofie ona faitauina. Afai e foliga tutusa ni vaega se lua o le code ae o le mea moni e eseese o latou talaaga, o le faamalosia o le "faaitiitiga" e mafai ona faigata ai le code. Saili se paleni: toe fa'aleleia pe a moni lava le uiga o le faaluaina ma e mafai ona suia faatasi.
5. Fausia se fausaga matagofie o le galuega
O se fausaga manino o faila e aʻafia ai le faigofie o le tausiga. Vaevae faila e tusa ai ma foliga poʻo le module, ae le naʻo le ituaiga faila, aemaise lava mo galuega tetele. O se fausaga lelei e faigofie ai mo tagata fou ona malamalama i le fausaga o le galuega.
Mo se faʻataʻitaʻiga, nai lo le tuʻuina o au vaega uma o le UI i totonu o le faila tele e tasi, e mafai ona e vaevaeina i latou e ala i foliga: `auth/`, `profile/`, `checkout/`, ma isi mea faapena. O lenei auala e fesoasoani i lau galuega faatino e faʻalauteleina aʻo faʻatupulaʻia.
6. Fa'atapula'a le faigata ma fa'afaigofie le fa'agasologa o le fa'atulagaga fa'atino e mulimuli ai.
O le code e tumu i fa'amatalaga fa'aputu if-else, le tele o tuutuuga, ma tuusaunoaga fa'apitoa e masani ona faigata ona fa'atumauina. Taumafai e fa'afaigofie lau mafaufau. E mafai ona e fa'aogaina ni metotia e pei o le early return e fa'aitiitia ai le fa'aputuina, pe fa'aliliuina le mafaufau faigata i ni galuega laiti e mafai ona fa'aigoaina talafeagai.
Afai e tele naua parakalafa o se galuega faatino, e faʻailoa mai ai foʻi le faigata. Mafaufau e faʻaaoga se mea faʻatulagaina (poʻo se fausaga faʻamaumauga) e faʻatulaga lelei ai parakalafa ma faʻafaigofie ai ona faʻalauteleina.
7. Tusi ni faʻamatalaga e saʻo lelei
E lē suitulaga fa'amatalaga i se tusitusiga manino. Afai e te mana'omia le fa'amatalaina "o le a le mea e fai e le tusitusiga," atonu e mana'omia ona faigofie ona faitau. Peita'i, e aoga lava fa'amatalaga mo le fa'amatalaina "aisea" e faia ai se mea, aemaise lava pe a iai ni fa'ai'uga i le mamanu, tapula'a o le faiga, po'o ni mafua'aga fa'apisinisi patino.
O faʻataʻitaʻiga o faʻamatalaga lelei e aofia ai le faʻamatalaina pe aisea e faʻaaogaina ai se algorithm faapitoa ona o tapulaʻa o le faʻatinoga, pe aisea e foliga ese ai se tulafono faʻamaonia ona e mulimuli i se tulafono faatonutonu. O le auala lea, o le a le "faʻamamaina" ai e isi le code ma faʻaleagaina ai le manatu taua.
8. Faaaoga taiala o le faatulagaga o tulafono ma sitaili
O le fa'atulagaina tutusa e fa'alelei ai le foliga fa'apolofesa o le code ma faigofie ona faitauina. Faaaoga linter ma formatters otometi pe a maua (e.g., ESLint + Prettier mo JavaScript, Black mo Python, po'o le gofmt mo Go). Fa'atasi ai ma nei meafaigaluega, e le tau popole 'au e uiga i le va ma le indentation, aua o mea uma e fa'atinoina otometi.
E fesoasoani fo'i ta'iala fa'a-sitaili: pe fa'aaoga upusii ta'itasi pe fa'alua, fa'apefea ona fa'aigoa faila, o afea e motusia ai laina uumi, ma isi mea fa'apena. O tulaga fa'atonuina laiti fa'apenei e mafai ona faia se eseesega tele i le lumana'i.
9. Tusi suega e faatumauina ai le mautinoa pe a toe faia ni suiga.
O le code e mafai ona tausia e le gata ina mama ae saogalemu foi e suia. O suega otometi (unit tests, integration tests) e faʻamautinoa ai e le solia e au suiga amioga ua uma ona faia. A aunoa ma suega, e masani ona fefefe tagata e faʻaleleia le code ona o le lamatiaga o ni mea sese e le iloa.
Amata i vaega taua: galuega tau fuafuaina o tau, tulafono fa'aitiitiga, fa'amaoniga, po'o vaega e masani ona suia. I le aluga o taimi, o le a fa'atupula'ia le ufiufi o su'ega ma maua ai le puipuiga malosi fa'asaga i le toe fa'afo'isia o tulaga.
10. Faia le toe fa'aleleia i taimi uma ma le fuaina
O le tausiga o se faagasologa faifai pea. O le toe fa'aleleia e lē o lona uiga o le "toe tusia o mea uma," ae o ni fa'aleleiga laiti e fa'aleleia atili ai le lelei o le code e aunoa ma le suia o lona amio. Fa'atulaga se toe fa'aleleia pe a e pa'i i se vaega o le code: fa'amama teisi, fa'asa'o le fa'aigoaina, vaevae se galuega e tele naua, pe aveese le code ua le toe aoga.
E sili atu le saogalemu o toe fa'aleleia laiti ma masani nai lo toe fa'aleleia tetele ma seāseā. Ma ia mautinoa i taimi uma ia lava le faia o su'ega, pe a itiiti mai o le siakiina, a'o le'i faia ma ina ua mae'a suiga.
11. Faamaumau faaiuga taua
I le fa’aopoopoga i fa’amatalaga fa’akomepiuta, o galuega lelei e masani ona i ai ni fa’amaumauga pu’upu’u: pe fa’apefea ona fa’agaoioia le talosaga, pe fa’apefea ona fausia, pe fa’apefea ona fa’atulaga le siosiomaga, ma se fa’amatalaga maualuga o le fausaga. E le mana’omia ona tele nei fa’amaumauga, ae e tatau ona sa’o ma faigofie ona maua. O se faila e tausia lelei e pei o le `README.md` e mafai ona sefe ai le tele o le taimi e fa’aofi ai sui fou.
Afai e iai se faaiuga taua faatekinolosi (e pei o le filifilia o se faamaumauga faapitoa, mamanu fausaga, po o se tapulaa o le tuufaatasia), faamaumau le mafuaaga. E fesoasoani lea i le au e malamalama i le talaaga ma aloese ai mai le toe faia o le talanoaga lava e tasi.
Fa'ato'a
O le code e mafai ona tausia o le taunuuga lea o ni masaniga lelei: tusitusi manino, vaevaeina o tiutetauave, tausia o le tumau, faaitiitia o le faigata, ma puipuia suiga i suega. E leai se code e atoatoa, ae o galuega faatino uma e mafai ona faaleleia pea pe afai e tautino atu le au i le lelei. I le faatinoina o fautuaga o loʻo i luga, o le a sili atu ona e saunia e manuia—e le gata i le asō, ae faapea foi i masina ma tausaga o lumanaʻi.
