管理感悟:程式碼缺的不是註釋,而是自解釋
重複一遍:
大家以為有用的註釋、文件,其實大多是沒用的。汝自己寫過什麼樣的有用註釋,文件?
以前看到一個說法:程式碼要有自解釋的特性,而不是寫大量註釋。深以為然。
註釋咱不說了,自解釋什麼意思?吾思考,有以下幾點:
目錄名、檔名、函式名、變數名,要夠長,能夠達到顧名思義的程度。這個說起來容易,其實大多數人做不到。這個時候吾建議照抄。
使用標準縮寫。如果自己創造了新的縮寫和名詞,要加以說明,並通用化(即碰到同樣情況,使用同樣的縮寫)。
儘量使用final這樣的修飾符。
其他的還有,模組化、弱耦合、強內聚、程式碼對齊等等。
說起來容易,做起來難。大多數程式設計師都會當作耳旁風,所以寫好程式碼的人不多(水平差的也看不出來)。
自然的,註釋、文件都是浪費時間的,不要盲目強調。
相關推薦
管理感悟:程式碼缺的不是註釋,而是自解釋
重複一遍: 大家以為有用的註釋、文件,其實大多是沒用的。汝自己寫過什麼樣的有用註釋,文件? 以前看到一個說法:程式碼要有自解釋的特性,而不是寫大量註釋。深以為然。 註釋咱不說了,自解釋什麼意思?吾思考,有以下幾點: 目錄名、檔名、函式名、變數名,
管理感悟:再好的設計,不如能執行的原型
最近負責一個專案,吾第一個事情,就是把事情想了一通,做了一個一期工程,即原型。為了這個原型: 連註冊登入都排到二期。 為了讓手機終端能夠同時開發,伺服器專門為此定時傳送訊息。 領導看了NOT FULL。為什麼呢?其實就是沒有一個長篇大論的方案和設計。怎麼
管理感悟:電費每月幾萬,主管的責任重於權力
都喜歡當主管。為什麼呢?當了主管,工資待遇提高是一回事,手上有了權力,想幹什麼就幹什麼,也是很過癮的。除此之外,還有什麼? 所在公司,前幾天買了約20個NVIDIA RTX 2080 顯示卡。一個顯示卡200W,公司在無錫這邊,研發幾十號人,機器更多,而且每個都有顯
阿里開發者們的第17個感悟:無細節不設計,無設計不架構
1月14日,無細節不設計,無設計不架構。這是我們送給開發者的第17個感悟。項籍,阿里巴巴新零售供應鏈平臺服務決策平臺負責人。在專家頁中如此介紹自己:“多年網際網路開發經驗,從事業務開發、平臺開發、架構設計、雲端計算、APM等領域。目前專注於供應鏈方向的解決方案治理和服務交易域”。作為問答頻道活躍的達人,歡迎交
阿裏開發者們的第17個感悟:無細節不設計,無設計不架構
vpd 模式識別 零售 1.5 src 應用 log term img 1月14日,無細節不設計,無設計不架構。這是我們送給開發者的第17個感悟。項籍,阿裏巴巴新零售供應鏈平臺服務決策平臺負責人。在專家頁中如此介紹自己:“多年互聯網開發經驗,從事業務開發、平臺開發、架構設計
管理感悟:技術好,又不服從管理的員工,怎麼辦
相信很多主管都遇到過,技術好又不服眾管理的員工。這讓主管很頭痛:管了吧,惹著他走人有點捨不得;不管吧,這工作沒法開展。怎麼辦? 首先,區分是暫時的,還是持續的。為什麼呢?因為人工作中經常發生爭吵,難免會影響情緒。於是一時不服從工作安排也是賭氣。這是常態,不要奇怪
管理感悟:產品功能比別人差,所以不能用?
NWT開業之初,跟別的公司有個專利官司。作為一個寫了很多專利的人,吾對此其實很不屑。不就一個專利嗎?能不能嚇唬人都是問題,還打什麼官司? 後來吾向公司同事(吾亦是領導,就不強調領導了)展示了投屏功能。幾個頭目看了很有興趣。吾突擊了兩個月,用C和安卓原始碼開發完成,然後整合到安卓版本里。C
管理感悟:主管加班,員工才會加班
搞軟體有沒有不加班的?也許有。軟體專案一般工期都很緊張,不加班任務肯定完成不了。那種理想化的完成工作就下班的想法,不現實。 要加班,首先主管要加班。主管不加班,員工根本不會加班。當然,個別員工是技術狂,遇到問題不解決極為難受,那是例外。為什麼呢?主管不加班,說明主管對這個專案不重視。主管
管理感悟:沒有活躍使用者量,談廣告都是開玩笑
去年,公司業務一直開展不起來。頭目們心不在焉,也沒有考慮怎麼回事,下一步怎麼辦。而研發總監李某自己連計劃都不想做,何況下一步工作。後來領導提起接入廣告(當時還接入了其他平臺),這個當然都有現成的範例程式碼,李某也整合到手機終端了。於是,一個星期就進了一點廣告收入(幾十還是幾百),然後就象炫寶一樣
管理感悟:作為一個主管,如何解決屁股與腦袋的矛盾
工作中,究竟是屁股決定腦袋,還是腦袋決定屁股? 從員工角度來講,希望老闆經常加工資,活安排得少,來不來上班都無所謂。 從老闆角度來說,希望員工不要工資,不吃不喝的加班。 顯然,雙方的想法都是錯誤的,所以雙方都要妥協。那麼,作為主管,究竟是屁股決定腦袋,還是腦袋決定屁股?我
管理感悟:搞清楚誰是你要團結的人,這是關鍵事情
個人分類: 管理感悟 所屬專欄: 管理感悟 前幾天領導乙請吾喝酒,叫了幾個朋友。其中一個丙現在惹上了麻煩(審計方面,這也不用大驚小怪,要找誰身上的問題都能找到。吾這麼辛苦工作,產出這麼多,領導甲還認為吾水平差沒產出呢)。丁正好是審計工作的,跟丙是多年的老朋友
演算法女博士被程式設計師嘲笑:程式碼能力太差,不知道怎麼招進來的
在某程式設計師聚集的論壇社群,一名程式設計師的吐槽引起了不少網友的熱議,其稱這名搞演算法的女博士問了一些很弱智的程式碼問題,直接暴露程式碼能力低下,並且還用了很誇張的語氣表示:嚇得我驚掉了下巴。言下之意,這名程式設計師認為這名女博士太水,不知道是怎麼招進來的,還是來自於中部某
管理感悟:獨當一面,很難
管理感悟:獨當一面,很難 紅朝儒生 2016-7-27 關鍵字:管理 獨當一面 簡介:工作中,能夠獨當一面的人是很少的。 感覺自己獨當一面,是很勉強很吃力的。為什麼?雜事太多,難以集中精力。 每個人都覺得自己聰明,都能幹大事。自
2018年航空概論課後作業(PS:部分答案不正確, 綜合得分:83.6)
方式 效率 設備 形式 燃氣 產品 差值 原理 基礎 1 【單選題】航空是指載人或不載人的飛行器在地球____的航行活動。 ? A、高空? B、大氣層內? C、宇宙? D、大氣層外我的答案:B 得分: 33.3分 2 【多選題】軍用飛機可分為____兩大類。 ? A、作戰飛
快速上手生成對抗生成網路生成手寫數字集(直接上程式碼以及詳細註釋,親測可用)
這裡插入幾張模型生成的圖片,從左到右分別是隨機生成的圖片,100輪之後的圖片,2000輪之後的圖片,8000輪之後的圖片。 程式碼雖然有100多行,但註釋大概佔了一般左右。一起交流,一起進步! import tensorflow as tf from matplotlib import
class的好處就是內部結構井井有條,程式碼沒有不裸露,都封裝到屬性或方法裡
class的好處就是內部結構井井有條,程式碼沒有不裸露,都封裝到屬性或方法裡 這是一個函式裡帶子函式的例子: def scope_test(): def do_local(): spam = "local spam" def do_nonlocal():
李家洋:初心不變,努力做好一塊鋪路石
@央廣軍事11月10日訊息,2018中國航展上首次公開展出的“瞭望者Ⅱ”察打一體導彈無人艇,是剛剛成功進行首發導彈飛行試驗命中靶心的實艇,試驗成功後隨即吊裝到展位與公眾見面。據媒體此前報道,該艇是中國第一艘導彈無人艇,也是繼以色列拉斐爾海上騎士後全球第二個成功發射導彈的無人艇,填補了國內導彈無人艇這一技術空白
管理感悟:抓住工作的主動權
今年初被忽悠到深圳。一次頭目甲請他的朋友(也曾經搞過視訊通話)來幫忙看看怎麼辦。這位朋友一看就是搞科研的,竟然講起了SIP的通訊流程,然後建議吾“看看SIP規範”。這邊專案都死了,看流程看規範能救活?能不能幫忙先解決問題?講了一個晚上,除了“推送”兩個字,別的其實什麼用也沒有。其實指手畫腳誰不會
管理感悟:一種招聘考試的想法
招聘有很多種方法。面試加考試,應該是個好辦法。那麼,如何考試?吾設想了以下內容: 電話的呼入、撥出功能設計。 撥號鍵盤功能設計。 數三角形。以前在中興培訓的時候數過。 算角度。吾自己都忘記什麼意思了。 緩衝、複用、繼承。 加密解密介紹。 大家可
Notepad++刪除程式碼中的註釋,可刪除//單行註釋和/**/多行註釋
申請軟體著作權時需要清除程式碼中的註釋,可以通過word和Notepad++組合操作來快速的完成 1。使用word的插入檔案功能合併多個原始碼檔案,操作方法為:新開啟1個word檔案,在“插入”標籤欄下找到“物件”點選右邊的小三角下拉選單裡選擇“檔案中的文字...”,然後在