[Powered by Google Translate] Katika video hii, tutaweza kujadili code style, ambayo ni kitu
kwamba ni karibu na wapenzi moyo wangu.
Sinema inaeleza jinsi code yako ni formatted, ambayo ni
huru kutokana na kile code ya kweli haina.
Si tu style nzuri kupata daraja bora katika CS50,
lakini pia kukusaidia kuandika kificho kwamba ni zaidi
someka na maintainable, ambayo, mwisho wa siku,
ni kwenda kufanya maisha yako rahisi sana.
>> tatu kuu vipengele ya style kificho kwamba tutaweza kujadili
video hii ni maoni, formatting,
na kutofautiana majina.
Hebu kuanza na maoni.
Kumbuka, maoni kuwa hakuna athari kwenye
utendaji wa code yako.
Hutumika tu kama mwanga msaada kwetu kama programmers.
Maoni mazuri wanatakiwa kujibu moja ya maswali mawili.
>> Kwanza, nini hii block ya maadili ya kufanya?
Hii ni maelezo ya muda mfupi na tamu ya madhumuni ya
mistari kwamba kufuata.
Kwa mfano, unaweza haja ya kutafuta mahali ambapo
kutekelezwa kipengele fulani ya kurekebisha
mdudu au kitu mabadiliko.
Bila maoni, unaweza haja ya pore juu ya mistari mingi ya
code kujaribu kufikiri hasa ambapo kipengele kwamba ni.
Au kama imekuwa ni siku chache tangu wewe Tumeangalia katika moja ya
mipango yako, unaweza kukumbuka yale fulani
kazi au kitanzi gani.
Hivyo maoni nitafanya reacquainting mwenyewe na
umri wa code, au acquainting mwenyewe na mtu mwingine
code, kiasi laini.
Swali la pili nzuri maoni majibu ni kwa nini mimi
kutekeleza mpango huu wa kuzuia kwa njia hii?
Kama wewe kuandika code, utasikia mara nyingi haja
kufanya maamuzi design.
Je, mimi kutumia kitanzi wakati au kwa kitanzi hapa?
Je, mimi kufanya hii ya kuzuia wa code katika kazi tofauti?
Kutumia maoni, unaweza hati design yako
maamuzi, ambayo itafanya code yako rahisi kuelewa
kwa ajili ya wengine, ambao wanaweza kuwa na kuuliza wenyewe huo exact
kubuni maswali kama wao kusoma code yako.
Au hata wewe mwenyewe, kama wewe kuja nyuma block ya maadili baada ya
baadhi ya kipindi cha muda.
>> Katika C, na lugha nyingine tutaweza kuona katika CS50, kuna
njia mbili ya kuongeza maoni kwa code yako, katika mstari wa maoni
na multi-line maoni.
Katika mstari wa maoni ni kubwa kwa kuandika vipande ya maadili ya
ndani ya kazi.
Kwa mfano, maoni katika-line inaweza kuelezea
madhumuni ya kwa kitanzi au kesi kona kwamba inalazimisha
hali hiyo.
Multi-line maoni ni kubwa kwa kuandika utendaji.
Kila wewe kuandika kazi, lazima daima, daima,
daima hati kile yake na maoni.
Hii ni pamoja na kile pembejeo kwa kazi, kuna nini
pato la kazi ni, na labda kwa nini kazi ni
kutekelezwa katika njia ambayo ni.
Kila wewe kubadili signature kazi wa, kurudi
thamani, au utekelezaji, ni muhimu pia update
sambamba nyaraka maoni.
mismatch kati ya maoni kazi na
utekelezaji inaweza kweli utata kwa wasomaji.
Vile vile, kujenga maoni mbalimbali juu ya mstari
ya kila c au.. h faili kuandika, kuelezea kile
file gani, pia ni wazo nzuri sana.
>> Kama wewe ni kutoa maoni code yako, moja ya maswali ya kwanza
wanaweza kuwa ni, vizuri, ni kiasi gani lazima mimi kutoa maoni yangu code?
Ni mara nyingi unnecessary niandike kila
moja mstari wa kanuni.
Kwa mfano, mstari kwamba anasema int x = 5 haina haja ya
maoni kuhusu suala hilo kuwa anasema "kuweka x 5 kwa".
Sio maoni ya kutosha, ingawa, kama tumeona, wanaweza kufanya
kuelewa code yako ni ngumu sana.
Hivyo utawala bora wa thumb ni maoni ya kuvutia ya vitalu
code, ambapo block lina mistari michache kuhusiana.
>> Basi hebu tuangalie mfano.
Hapa ni uncommented C kazi.
Okay, kwa vile hii ni kazi, jambo la kwanza tunahitaji kuongeza
ni maoni kuelezea ni nini kazi ya pembejeo
ni na nini anafanya.
Basi hebu kuongeza maoni mbalimbali ya mstari.
Mkuu.
Sasa sisi kujua nini hasa kazi yetu haina.
Hebu kuongeza baadhi ya comments katika mstari wa sasa.
Tunaweza kugawanya code yetu ndani ya vitalu mbili ya mistari kama hiyo.
Mistari 4 na 5 masharti ya kujenga misingi ya pembejeo na
mistari 6 kupitia pato 9 wale
masharti ndani lyrics song.
Hivyo hebu hati kwamba pamoja na maoni.
Ajabu.
Sasa kazi yetu ni maoni.
>> Ona kwamba yetu katika mstari maoni hawana haja ya kutumia kamili
sentensi au mwisho kwa kipindi hicho.
Ni muhimu kwamba kuna nafasi kati ya pili slash
na mwanzo wa maoni.
Hii ni ya mzunguko wa maoni ndani ya mipango yako
kwamba unapaswa kuwa risasi kwa.
Ona hapa jinsi sisi waliojitenga vitalu mbili ya maadili kuhusiana
ndani ya kiitio wetu kazi na kurudi ziada carriage.
>> Hii inatuleta kwenye sehemu ya pili ya style kificho,
formatting.
Wakati mimi kwanza ilianza programu, mimi hit Enter
muhimu sana kwa nadra, ambayo ilisababisha giant, unreadable
blobs ya maadili.
Nadhani kwa kweli mashaka mafundisho mwenzangu, tangu yeye
hakuwa na furaha sana na mimi.
Kuibua kambi ya vitalu code kuhusiana, kutumia carriage
anarudi, wanaweza kufanya code yako rahisi kwa skim na uwazi
delineate ambayo mistari ya maadili ya maoni yako ni kueleza.
Kwamba kuwa alisema, kueneza code yako sana, kama kwa
mbili au zaidi kati ya mistari vitalu code au majukumu, unaweza
pia kufanya hivyo kiasi kidogo someka.
>> Indentation ni mwingine muhimu
nyanja ya format code.
Daima, daima, daima Indent mwili wa kazi, loop,
au hali.
Hii inafanya kuwa wazi ambayo mstari wa kanuni ni ndani ya
kitanzi, kwa mfano, na ambayo mstari wa kanuni
ni nje ya kwamba.
CS50 inapendekeza kwamba Indent na nafasi nne, lakini
kama kuchagua kitu kingine, kuwa na uhakika wa kuwa thabiti
katika code yako.
On note kwamba, CS50 inapendekeza kwamba mahali braces
kwenye mstari yao wenyewe.
Kwa njia hiyo, braces itakuwa kujipanga kuibua kushoto sawa
kiasi, hivyo ni kioo wazi ambapo block huanza na kuishia.
Hata hivyo, pia ni sawa na kuweka braces kwenye mstari huo kama
hali, kwa mfano, kuhifadhi nafasi.
Kama wewe kufanya hili, ingawa, hakikisha ni pamoja na nafasi
kabla brace curly hivyo si smooshed karibu na kufunga
Paren au neno.
>> Kwani kuchagua, jambo muhimu zaidi ni kuwa
thabiti katika code yako.
Nini hatutaki kuona, ingawa, ni
indented braces curly.
Kufanya hivyo hufanya braces kuonekana imetenganishwa kutoka
hali, kitanzi, au kazi wao ni kuweka mipaka, na kufanya
code vigumu kusoma.
Katika C na lugha nyingine tutaweza kuona, curly braces ni
hiari kwa hali moja ya mstari au matanzi.
Ni faini kwa omit braces curly katika kesi hii, lakini kama
huna hivyo, kuwa na uhakika wa kuwa thabiti
katika code yako.
>> Wakati kufafanua kazi, CS50 inapendekeza kuandika
kurudi aina ya kazi juu ya mstari huo kama jina la
kazi.
Hata hivyo, pia ni OK kuandika aina ya kurudi juu yake mwenyewe
line, ambayo inaweza kufanya kazi rahisi kupata ufafanuzi katika
wahariri Nakala baadhi.
>> Hatimaye, kuwa na uhakika wa ni pamoja na maeneo ya karibu
maneno na waendeshaji.
Kwa mfano, mstari kwamba anasema int x = 5 ni rahisi sana
kusoma kama kuna nafasi kuzunguka ishara sawa.
Vilevile, hakikisha una nafasi baada ya maneno kama kama,
kwa, na wakati.
Bila nafasi, hizi inaweza kuangalia kama wito kazi,
ambayo siyo.
>> Basi hebu tuangalie mfano wa kutumia mtindo mzuri
kwa kuzuia iliyofomatiwa vibaya wa kificho.
Okay, wacha kuanza kutoka juu.
Tunaweza kuona kwamba brace ufunguzi wa kuu ni juu ya huo
mstari kama jina kazi ya.
Kama sisi ni kwenda kufanya hivyo, lazima kuna nafasi kati ya
Paren kufunga na Brace, kama hii.
Hata hivyo, CS50 inapendekeza kwamba braces kusimama
kwenye mstari yao wenyewe.
Basi hebu kufanya hivyo.
Sasa kwa kuwa tuko katika mwili wa kazi kuu, tutaweza haja
kuanza indenting code, tutaweza kutumia
ilipendekeza nafasi nne.
Next, tunaona kwamba kuna nafasi hakuna kuzunguka ishara sawa
hapa, hivyo hebu kuongeza kwamba.
Hapa, tunaona kwamba hakuna nafasi kati ikiwa na
Paren wazi, hivyo hebu kuongeza kwamba, pamoja na baadhi ya nafasi kuzunguka
mkubwa kuliko ishara.
Tena, sisi kuona hakuna nafasi kati ya Paren kufunga na
Brace ufunguzi hapa.
Kama sisi ni kwenda kuweka haya juu ya mstari huo huo, kuna haja ya
kuwa nafasi kabla brace curly.
Hata hivyo, inaonekana kama mwili wa wetu
hali ni moja tu mstari.
Hivyo hatuna haja ya ni pamoja na braces wakati wote.
Sisi sasa haja ya kuwa na uhakika wa Indent katika mwili wa kila
yetu hali.
Sisi dhahiri hawataki line hii ya mwisho ya kuwa juu ya huo
hit line kama mwingine, hivyo hebu Ingiza na Indent.
Hatimaye, kufunga curly brace kwa ajili ya mahitaji kuu ya kuwa juu ya
line yake mwenyewe.
>> Tunaweza kuona hapa tuna mbili tofauti
vitalu ya maadili kuhusiana.
Mistari 4 kupitia 6 kuchochea mtumiaji kwa ajili ya pembejeo na
iliyobaki mistari kuonyesha kwamba pembejeo kwa mtumiaji.
Hivyo ni mantiki kuweka baadhi ya nafasi kati ya vitalu hizi mbili
kwa ufafanuzi.
Na kuna sisi kwenda, sasa code hii ni rahisi sana kusoma na
nzuri style.
>> Hatimaye, hebu majadiliano juu ya sehemu yetu ya tatu ya style nzuri:
variable majina.
Majina yako variable lazima kueleza
thamani kwamba kuwakilisha.
Hebu kupitia upya mfano wetu mapema.
Chupa ni nzuri maelezo jina kwa variable kwamba
inawakilisha jinsi wengi chupa ni kushoto juu ya ukuta.
Majina kama x au numBots si sana maelezo na ni
si nzuri kwa ajili ya usomaji wa code yako.
Wakati vigezo jina lake na barua moja ni ya kawaida katika
math na maeneo mengine, wanaweza kufanya code yako ngumu sana
kuelewa.
ukiondoa utawala huu ni iterator
vigezo ndani ya matanzi.
Katika kwa tanzi, kwa mfano, ni faini ya kutumia variable
majina kama i, j, na k kwa iteration.
Wakati kujenga vigezo iterator ndani ya tanzi, ni
ilipendekeza kwamba kufanya hivyo ndani ya kitanzi yenyewe, badala
kuliko nje ya loop, ili tuweze kuweka vigezo kama
kukazwa scoped iwezekanavyo.
>> Kwa upande mwingine, jina variable kama idadi ya chupa
kushoto juu ya ukuta ni, wakati maelezo, overly verbose
na si lazima.
Katika tukio wewe unataka kujenga variable na
maneno mengi, kutenganisha maneno hayo na underscores.
Kwa mfano, is_ready ni mengi zaidi kuliko someka isReady.
Ni faini kutangaza vigezo mbalimbali juu ya mstari huo.
Hata hivyo, ikiwa kufanya hivyo, si initialize baadhi ya vigezo lakini
si wengine.
Hiyo ina maana kitu kama dimes int, pennies
semicolon, ni sawa.
Lakini int dimes = 0, pennies
semicolon si.
>> Hatimaye, wakati akitangaza kuyatumia, ni ilipendekeza
utakapoweka kinyota karibu na aina pointer, siyo
jina la kutofautiana.
Hivyo int p * inapendekezwa kuliko int
nafasi * p.
Whoo!
Hivyo kwamba inaonekana kama mengi ya sheria kwa
kukumbuka, lakini usijali.
Kama milele katika shaka, usisite rejea ya CS50
online style mwongozo.
>> Hebu haraka muhtasari muhimu
pointi ya style code.
Kwanza, maoni code yako.
Daima, daima, daima kufanya kazi kueleza kile
na maoni mbalimbali ya mstari na maoni kila mistari michache ya
code katika-line.
Pili.
Kuwa thabiti na code formatting yako.
Makini na Kuwekwa yako na matumizi ya braces
kama vile nafasi kuzunguka maneno na waendeshaji.
Hatimaye, kuchagua majina maelezo kutofautiana.
Vigezo lazima kueleza thamani yamesimamia, lakini
haipaswi kuchukua wewe milele na aina.
>> Na kwamba ni.
Yote hii itakuwa haraka kuwa asili ya pili kama wewe
kuandika zaidi na zaidi ya kificho, na wewe utakuwa coding
kwa mtindo katika wakati hakuna.
Jina langu ni Tommy, na hii ni CS50.