跳到主要內容

Writing Solid Code

這本書真的很棒!改變了我很多的想法,也教了我很多避免錯誤的方法,其實看我們的程式碼,會發現其實很多地方有遵守這些規則,當然有些地方沒有。有些原則,我認為不需要,而有些原則我持不一樣的看法。這都值得拿來討論。

有幾點感想:

1. 不僅要有防禦機制,還要有紀錄與防止錯誤的維護機制,例如輸入函式的資料流超出預定範圍,除了得考慮是讓函式無作用,我覺得更重要的是進一步,紀錄錯誤,通常只有在使用者輸入資料方面,我們會作警告的對話框,若是資料讀錯,或程式自己計算出未預期的錯誤,通常會吃下來,不動作。但更好的作法應該是把他記錄下來,並且注意為什麼錯!c++的throw catch或許是個很好機制,應該試著建立起類似的維護機制。

2. 有範例的註解,並且注明可能誤用的狀況。

3. 逐步Trace 寫過的code,所有的分支判斷都要跑過避免,只測到單一狀況。這有另一像好處,為了少跑一次分枝測試,會試著把不需要的if去掉,或將特例集中處理,增進效率。

4. 不要寫通殺的程式,亦造成歧異的函式越容意造成bug。

5. 注意需求的語意,不要利用其他功能的特性來達到需求的目的,容易發生不要的副作用。例如將nStep+(i==j),將true當作數字來使用。

6. 較短的程式不一定跑的比較快,KISS原則。

7. 關於態度的章節,有非常深的感慨,因為我有不少他講的缺點。49-61條每一條都是金玉良言啊!

8. 程式開發準則的優先順序,之前似乎有想過這樣的問題,有些時候我也拿捏不了那個準則應該優先,我會想兩個以上的解決方案,請俊賢替我決定,當然我也不知道他的準則是什麼,哈哈。我覺得在每個不同的開發專案,可能因為不同的需求特性,開發準則優先順序會有所變動。這在開發前,PM應給予適當的提示,講白話一點,就是你要寫的有彈性點,還是這只是暫時方案,後續維護不干我們的事或下一版就會全面更新了,這樣寫法會有很大的不一樣。通常我是覺得要做的很彈性很麻煩,我才會問到底想要作怎樣,我預設都是將來改變規格,我也可以很快的應變,但是最近我發現,之後變動處都不是我預期變動的地方XD。

以下是書中提到的各要點:

1. 啟動所有編譯器中的預警功能。
這點我就認為不需要了,適當等級除錯便可。

2. 利用lint找出那些編譯器所找不到的錯誤。
可移植性的測試,我們的系統大概沒有這樣的計畫,如果要跑也絕對改不完。

3. 有單元測試就做,不要跳過去。
我們好像沒有這樣的東西,vs2005好像有。

4. 請同時保有“偵錯版”及“發行版”。
原本就有啦!

5. 請利用assert維護巨集來確認函式引數的正確性。
這是第一個學到的重要招式,不只防禦錯誤,還要進一步標示錯誤處。或許利用C++的throw catch機制,也是不錯替代方案。得好好研究。

6. 避免讓程式產生未定義的行為,不然就在這些地方加上檢查巨集,以免有人誤用了這些未定義的結果。
防禦機制,IMMain的程式充滿這樣的漏洞。

7. 適時地加上註解,以免浪費別人的時間來看懂您的檢查巨集。
這我覺得我做的還ok,雖然有時候我也看不懂我一年前寫的註解XD。

8. 拿掉含糊的假設,否則請加上檢查巨集來檢查這些條件。

9. 利用檢查巨集找出不該在正常情況下發生的現象。

10. 防禦性的寫程式時,不要把臭蟲藏起來。

11. 利用不同的演算法來協助您確認程式的結果。
其實只要跟emdist比對就好了XD

12. 避免產生隨機行為,並且讓錯誤無所遁形。
指的是消除程式語言未定義處,如使用未初始化的記憶體。很重要!

13. 清除不能使用的記憶體空間,以免誤用了它的資料而不自知。
這常發生在誤用容器資料。

14. 程式中如果有些行為太少發生了,就強迫它多發生幾次。

其實這除錯技巧常使用。
15. 多保留一些系統資訊,有助於進行更嚴謹的除錯。
這有在做,只是好像沒啥效果XD。

16. 徹底建立子系統的檢查程序,並且盡可能地去使用它。
這對畫圖好像有用,可以用來檢查暴表資料,有空寫一個試看看。

17. 小心地設計測試條件,從各種可行的方法中慎選最好的。
這觀點很好用,用0XA3這種亂數比0x00更容易發現錯誤。

18. 致力寫出無形的,而且完整的測試。
這是一個更高的境界,書上說如何藉由程式讓不懂特例狀況的菜鳥,在寫錯後就自動發現錯誤了,看起來好神啊!

19. 不要以發行時的標準來苛求偵錯版本,偵錯能力是必須犧牲速度及程式大小換來的。
偵錯版,要寫很多檢查code就對了。

20. 不要等到錯誤發生,才被迫去逐步追蹤程式。
很重要的一點,在寫的時候就一步一步去追蹤自己寫的code。

21. 逐步追蹤您的程式。
每條路線至少追蹤一次,這條件看起還挺嚴苛、費時的。盡力去做吧!應該可以提早找到bug。

22. 逐步追蹤程式的時候,請多注意資料的流向及內容。

23. 以原始程式指令為單位無法知道所有執行的細節,面對重要的程式碼最好以組合語言指令為單位來逐步測試。
這....我想bug產生後,真的查不出來再說吧!看不懂組語,囧。

24. 讓程式的介面為程式師把關,使他們不至於忽略錯誤的情況,不要將錯誤代碼跟輸出的結果一起放在返回值中。
以前從來沒發現這個要點,得多加注意。

25. 不時地檢查、並且去除函式介面裡的缺失。

26. 不要以一個函式來包含多項功能;盡可能讓每一個函式只完成一項獨立的功能,這樣有助於我們做更完整的引數檢查。
一個函式一個功能,不要寫個通殺的函式,有幾個函式我好像這樣搞過,真糟糕。

27. 清楚地定義函式的引數,不要弄得模稜兩可
先限制較嚴格的條件,有用到再放寬條件。

28. 確定函式的輸入值都是正確的,以避免函式傳回“輸入錯誤”的訊息。

29. 讓一般的程式師都能由函式的定義看出函式的呼叫方法,並且避免使用布林值來當引數。
其實我覺得只是要不要再函式定義處寫引數的註解,還是要利用參數定義來更清楚表達引數的定義罷了,有蕃茄這只是多按個紐而已,我覺得沒差。只是二選一。

30. 用註解來強調函式中潛在的危機。
恩!這很重要,最好還要加上正常用的範例。

31. 利用良好定義的資料型別。
可攜性的問題,我們大該不需注意。

32. 隨時注意變數會不會產生溢位或不足位的現象。
比較少碰到,通常轉換時才會發生吧。

33. 寫程式的時候要盡量依照原始的設計,任何無心的偏差都可能造成始料未及的錯誤。
對設計上語意的掌握,2.0.0有犯了這個錯誤。

34. 盡量使每一個步驟都只用一段程式來完成。
其實這段例子跟他的結論,我覺得不太搭。他想表達啥,看不懂XD。

35. 去除多餘的if。
我覺得這要有高超的技巧,這不容易啊!

36. 避免層層疊疊的使用?:運算子。
糟糕我常用XD!

37. 盡量使同一類的特殊狀況只用一段程式處理──將相同的條件敘述合成一條,把特例一次處理掉。

38. 避免採用程式語言的危險慣例。

39. 若非必要,不要任意將不同類的運算混在一個式子裡。萬一必須將不同的運算放在一起使用,就用括號來標明運算的順序。

40. 避免呼叫會傳回錯誤碼的函式。

41. 不屬於自己的記憶體,就不要使用。

42. 不要去使用已經被我們釋放的記憶體空間。

43. 不要把用來傳輸出結果的記憶體拿來當成作業時的暫存空間。

44. 不要以 static(或整體性)的空間來傳資料。

45. 不要讓我們的函式變成“寄生蟲”。

46. 不要濫用程式語言的特性。

47. 將 C 的原始程式寫短,編譯出來的執行碼不見得就會有效率。

48. 寫程式要盡量讓一般人看懂。

49. 錯誤不會自己“跑掉”。

50. 發現錯誤立即修正,莫待將來付出更慘痛的代價。

51. 不能只是解除錯誤的表象,要除掉病因才能真正解決問題。

52. 除非為了讓軟體更成功,非修改不可。否則不要隨便“整理”程式。

53. 不要增添沒有必要的功能。

54. 任何一項功能都要付出代價。

55. 不要容許沒有必要的彈性。

56. 不要盲目地從一堆“嘗試”中去找答案;將時間用來找尋“最正確”的方法。

57. 每完成一小部份,就先回頭測試一遍。不管進度是不是落後,一定要徹底地將程式測試過。

58. 不能只靠測試小組來除錯。

59. 不要錯怪測試人員存心找麻煩。

60. 建立適用的優先順序,並確實地依照這個標準來做取捨。

61. 不要讓同一個錯誤有再次出現的機會。

留言

這個網誌中的熱門文章

勝券在握

其實這本書,感覺上寫的有點雜,比上一本講巴非特的書更難懂,兩個講的東西其實是一致的。投資原則便是先選產業,再選公司,慎選時機進場。只買了解的企業是價值投資一貫的原則。價值投資的書大概就先看到這裡了,彼得林區不知道是屬於那一類的,接下來大概會看這部份的書。暫時的目標是把杜金龍介紹的書單看完,真的還不少。接下來的投資會以巴菲特的方法來做,感覺上這比較適合我,練習把漲跌不當一回事,對我而言真的很重要。期權大概不會再玩了,買了以後一直在看漲跌,令人受不了。工作時都不能專心。 就價值投資人而言,真的不需要我們的產品,因為第一點就把我們程式特性打死,不理會股票市場的漲跌,這樣報價功能就沒什麼意義了,價值投資根本不需要技術分析,除非我們能提供相關價值投資的資訊,但我們基本分析真的很爛,看不到什麼資料。有機會我來思考一下價值投資到底要什麼資料,能不能把他寫成一個可運用的程式。 以下是我認為重要的書摘,其實這也只包含最後一章,我認為也只有這章值得做書摘。 巴非特相信使用短期價格來判斷一家公司的成功與否是愚蠢的。取而代之的是,他要公司向他報告因經濟實力成長所獲得的價值,一年一次,他固定檢查幾個變數: 初始的股東權益報酬率。 營運毛利、負債水準與資本支出需求的變化。 該公司的現金產生能力。 如果這些經濟指標正在進展,他知道長期下來,結果會反應在股價上。短期之內,股價所發生的是是不合常理的。 投資策略 不理會股票市場每日的漲跌 不擔心經濟情勢。 買下一家公司,而不是股票 管理企業的投資組合 巴非特原則 企業原則 這家企業是簡單且可以了解的 了解一家企業如何產生利潤的相關經濟活動。 這家企業的營運歷史是否穩定 他必須經得起時間的考驗。 這家企業的長期發展前景是否看好 市場特許權,五力分析 經營原則 經營者是否理性 理性的經營者將只會把多餘的現金,投資在那些產生較資本成本報酬率為高的計畫裡。 經營者對他的股東是誠實坦白的 報告時能知道營業部門如何營業,坦承失敗,了解公司的目的是使股東權益報酬率達到最大。 經營者是會盲從其他法人機構的行為 當心『其他公司也這麼做,一定沒問題』為自己行為辯護的經營者。衡量經營者競爭力的一個方法是,看他們如何運用自己的思考能力以避免依附群眾心理。 財務原則 把重點集中...

10/17部會心得

其實部會一開完,我就想寫了,只是最近沉迷於小說,直到今天才有開始動工的心情。 業務的報告部份就不要講了,一點都不感興趣,講的好像會大賣的樣子,薪水有增加再說啦! 技術方面, DQ 做的功能好像挺有意思的,不過感覺上沒人看出他的價值,不過我覺得最佳的 UI 還是 vs 2005 為主,如果要研發基底的 UI 我覺得要以類 VS 為目標。金融網的東西也令人興奮,我本來就覺得網頁的東西潛力無窮,雖然是抄的,不過覺得還不錯,網頁互抄比 AP 互抄容易多了,很多 AP 的功能要模擬出來,真的比想像中難太多了。雖然金融網聽到最後我睡著了,但我非常期待他下一版能帶來什麼。好吧!說一下我們這邊技術心得,看起來炫,但是我一點都不心動,因為我想不到這東西能增加我們產品的價值嗎? 這場部會最棒的是最後副總的報告,這是第一次瞭解整個產業環境與我們的應對方法,這樣我才清楚為什麼要成立那麼多非資訊本業部門,金融網成立的原因何在,產業鏈垂直整合的價值在哪裡。但是會像如規劃中的成功嗎?其實從旁觀察規劃與現在實際的運作,我抱的期望沒那麼大,不過這是有意思的夢,就看能不能實現囉! 不過在會中,我就想到一個我覺得可以配合上我們的產業架構,而且還不錯的商業模式,這也是我想寫這篇心得的原因。 在副總的報告中,提到金融網是為了提供一個入門的金融資訊,接觸最底層不付費的又想看金融資訊的民眾,其實我想到更進階的是接觸所有上網的人。而這功能結合 43thing 與財務規劃(參考 到底要賺多少錢才能退休呢? )你要作這些你想要做的事情(如遊學、旅遊)或退休,你到底要賺多少錢,然後開始洗腦光靠上班的死薪水是達不成這些目的的,所以要開始投資,投資如何規劃,就是要買我們的金融產品,一步一步引君入彀。這功能主要的對象就不只是想投資的人,而是所有的人,只要你心中有任何的夢想,而這夢想需要錢來達成,就需要這個工具。這就是把基底做的更大,個體經濟學常用的互補效應。所以這功能包含紀錄你要達成的夢想,財務管理包含薪資增加目標、稅務、相關的投資規劃與風險等。目標就是吸引所有人來理財、投資。 另一方面,我想倒也有一些人就是他沒有時間也沒有能力去學如何投資或操作股票,他們只想跟老師聽名牌,那這個就可以結合 blog 的功能來作,吸引一些老師來 blog 建立個人投資說明,開發一個跟單工具,這跟單工具可以比較所...

Web2.0在促銷產品的應用

我想說明一下我在星期五上所提得話題是有背後的理由的,我提到Rss一直無法突破成為一般大眾接受的技術,討論這話題的主要原因是想提醒大家如果你面對的是一般使用者不是進階使用者,這技術可有可無,不會特別增加你的網站流量和黏度。不要跟我講有總比沒有好,請把精力花在重要的地方,這是我的想法,有太多東西該做,不怎麼重要的東西留到最後。第二個我最後提到的問題,研究這個是要幹嘛,要做個2.0網站做啥。原來是要推銷我們的產品,這倒有點意思了,一般我在Mr6上看到介紹有關新型態的網站很少推銷單一產品的,大部分被人稱作Web2.0的網站,通常都當自己為媒體平台來賺錢,如部落格利用Google AdSence賺錢、各相簿與部落格網站也利用版面廣告賺錢、Dig類型或書籤分享類型,也是利用內容特性插入版面廣告賺錢。對單一產品做行銷,好像是所謂Web1.0的特色。行銷單一產品在Web2.0我是沒看過,但是我到是看過一兩則介紹利用blog提昇企業形象,毛寶的企業 blog ,以及我上一篇打的 經商利器部落格 ,或許這適合我們情況。 因此我的想法是架一個部落格,專門探討財經的議題,譬如如何選股,選股該看哪些資訊,這個時段有哪些飆股可選,帶入我們的程式來展現,就像pre sale開課一樣。但是就如那篇經商利器提到的不是介紹我們商品多好、多與眾不同。而是提供一個分析、一些觀念,是有血有肉的內容。從建立關係再來賣產品。企業部落格重點在於溝通,讓客戶了解我們產品的理念,我們聽到他們的需求、意見與批評,有好的也有可能有壞的。並且從這邊或許我們會得到一些反饋,作為開發新產品的基礎。至於怎麼宣傳,這倒容易可以學有名的個人財經部落格 楚狂人 ,每有一篇新著作就到國內最大社群網站ptt po文,只要有內容,人數保證衝的很快,持續不斷的更新,一定會有黏度的。但是可能的缺點是,ptt鄉民一般對商業性宣傳有潛在性的反感,如何改善或隱藏這缺點或許是個重點。總而言之,如果是用blog形式宣傳,最重要是內容與持續不斷的更新,但這不會馬上看到效果,朝這方向做心理要有個底,會有一段毫無績效而令人氣餒的時期。 就技術而言,blog的架設,建議使用wordpress,這架站軟體,不用浪費時間自己一個一個功能寫出來。 其實如果不是以行銷我們產品為目的,我的想法跟仲甫不謀而合,叫做digstock,讓大家去推或噓特定股票,從基本面、技術面...