av一区二区在线观看_亚洲男人的天堂网站_日韩亚洲视频_在线成人免费_欧美日韩精品免费观看视频_久草视

您的位置:首頁技術文章
文章詳情頁

PHP代碼注釋小細節

瀏覽:95日期:2022-09-11 16:40:33
代碼注釋,可以說是比代碼本身更重要。告誡新人,一定要養成寫注釋的習慣,否則只能是損人不利己。這里有一些方法可以確保你寫在代碼中的注釋是友好的,總結起來就是'5要與3不要'一、不要重復閱讀者已經知道的內容(×)一些光看方法名,光看代碼就能看出來功能的就沒必要寫注釋,// If the color is red, turn it greenif (color.is_red()) { color.turn_green();}二、要注釋說明推理和歷史(√)如果代碼中的業務邏輯以后可能需要更新或更改,那就應該留下注釋:/* The API currently returns an array of itemseven though that will change in an upcoming ticket.Therefore, be sure to change the loop style here so thatwe properly iterate over an object */var api_result = {items: ['one', 'two']}, items = api_result.items, num_items = items.length;for(var x = 0; x < num_items; x++) { ...}三、同一行的注釋不要寫得很長(×)沒什么比拖動水平滾動條來閱讀注釋更令開發人員發指的了。事實上,大多數開發人員都會選擇忽略這類注釋,因為讀起來真的很不方便。function Person(name) { this.name = name; this.first_name = name.split(' ')[0]; // This is just a shot in the dark here. If we can extract the first name, let’s do it}四、要把長注釋放在邏輯上面,短注釋放在后面(√)注釋如果不超過120個字符那可以放在代碼旁邊。否則,就應該直接把注釋放到語句上面。if (person.age < 21) { person.can_drink = false; // 21 drinking age /* Fees are given to those under 25, but only in some states. */ person.has_car_rental_fee = function(state) { if (state === 'MI') { return true; } };}五、不要為了注釋而添加不必要的注釋(×)畫蛇添足的注釋會造成混亂。也許在學校里老師教你要給所有語句添加注釋,這會幫助開發人員更好地理解。但這是錯的。誰要這么說,那你就立馬上給他個兩大耳刮子。代碼應該保持干凈簡潔,這是毋庸置疑的。如果你的代碼需要逐行解釋說明,那么你最需要做的是重構。if (person.age >= 21) { person.can_drink = true; // A person can drink at 21 person.can_smoke = true; // A person can smoke at 18 person.can_wed = true; // A person can get married at 18 person.can_see_all_movies = true; // A person can see all movies at 17 //I hate babies and children and all things pure because I comment too much}六、注釋要拼寫正確(√)不要為代碼注釋中的拼寫錯誤找借口。IDE可以為你檢查拼寫。如果沒有這個功能,那就去下載插件,自己動手!七、要多多練習(√)熟能生巧。試著寫一些有用的注釋,可以問問其他開發人員你的注釋是否有用。隨著時間的推移,你會慢慢懂得怎樣才算是友好的注釋。八、要審查別人的注釋(√)在代碼審查時,我們往往會忽略查看注釋。不要怕要求更多的注釋,你應該提出質疑。如果每個人都養成寫好注釋的好習慣,那么世界將會更美好。九、對注釋一定要知道的的精華總結注釋是開發進程中非常重要的一部分,但我們不應該為了注釋而注釋。注釋應該是有用的,簡潔的,應該是對代碼的一種補充。注釋不應該用于逐行地解釋代碼,相反,它應該用于解釋業務邏輯,推理以及對將來的啟示。
標簽: PHP
相關文章:
主站蜘蛛池模板: 亚洲国产欧美日韩在线 | 国产黄色一区 | 亚洲视频免费在线观看 | 色在线播放 | 亚洲另类色图 | 久久性生活视频 | 午夜视频网 | 毛片网站免费 | 亚洲小说欧美激情另类 | 成人三级晚上看 | 亚洲综合五月天婷婷丁香 | 国产视频成人 | 久久中文视频 | 日韩精品三级 | 狠狠狠狠干 | 成人免费视频一区二区 | 欧美一级在线观看 | 一级特黄视频 | 一区在线观看 | 五月激情综合网 | 亚洲一级大片 | 日本精品久久久 | 日韩一二区 | 一区二区黄色 | 91久久综合亚洲鲁鲁五月天 | 成人深夜视频 | 免费看黄色网址 | 欧美国产在线视频 | 99小视频 | 又色又爽又黄gif动态图 | 欧美精品一区二 | 毛片网站在线播放 | 欧美一级黄 | 国产一二 | 国产91清纯白嫩初高中在线观看 | 成人片在线看 | www视频在线观看网站 | 欧美一级免费 | 欧美一区二区三区不卡 | 精品一区二区三区免费毛片 | 成人免费毛片男人用品 |