[Engineering] 編程哲學(xué)(七):我寫不出好代碼

我們?cè)跒閯e人編程

編程垮媒,是一個(gè)解決問題的過程,
通過對(duì)問題本身進(jìn)行分析驾胆,考慮目前可用的計(jì)算資源涣澡,
整合出一套自動(dòng)化的解決問題的步驟贱呐,就是程序丧诺。

在這個(gè)過程中,我們需要發(fā)現(xiàn)規(guī)律奄薇,找到普適性驳阎,
以降低軟件的成本,覆蓋大部分場(chǎng)景,
這是我們每天要做的事情呵晚。

我們很少為自己編程蜘腌,
我們做軟件,并不是為了解決自己的問題饵隙,而是幫用戶撮珠,
我們提供了一個(gè)代碼庫,也不是為了自己金矛,而是因?yàn)閯e人要用它芯急。

因此,僅僅創(chuàng)造一個(gè)解決方案驶俊,這并不夠娶耍,
還得告訴別人,該如何使用它饼酿,
編程的藝術(shù)或許在于如何提供功能榕酒。

這是一件很容易被忽視的事情,
解決方案的創(chuàng)造者故俐,默認(rèn)是會(huì)使用它的想鹰,所以很難體會(huì)用戶的心情。
那種靈活到幾乎做什么都行购披,卻沒有一種方法可行的感受杖挣。

看似簡(jiǎn)單的事情

天才程序員寫的代碼庫很簡(jiǎn)單,可重復(fù)使用刚陡,且功能強(qiáng)大惩妇。
我們寫的代碼庫比較復(fù)雜,沒有人知道該如何使用它筐乳。

這并不是一個(gè)巧合歌殃,
并不是我們剛好遇到了一件麻煩的事情,
而是我們本來就不知道如何寫出好用的代碼蝙云,我們寫不出來氓皱。

我們知道漂亮的代碼長(zhǎng)什么樣,知道如何使用它們勃刨,
并不意味著我們也可以寫出這樣的代碼波材。
膾炙人口的文章人們都想寫出來,可是卻只有少數(shù)人能夠辦到身隐。

這需要長(zhǎng)期的訓(xùn)練以積累經(jīng)驗(yàn)廷区,需要仔細(xì)的斟酌,
需要考慮如何提供一項(xiàng)功能贾铝,而不僅僅是實(shí)現(xiàn)它隙轻,
需要把自己當(dāng)做對(duì)系統(tǒng)一無所知埠帕,然后再教會(huì)自己。

大部分人都不擅長(zhǎng)這一點(diǎn)玖绿,
畢竟考慮功能該被如何使用敛瓷,與考慮功能該被如何實(shí)現(xiàn),是兩件不同的事情斑匪。

無微不至的軟件服務(wù)

如果我們沒辦法寫出那么好的代碼呐籽,那就只能多提供一些幫助信息了。

我們不得不寫上足夠多的注釋和文檔蚀瘸,
解釋我們?yōu)槭裁匆@么做绝淡,以及軟件的用法。
解釋我們正在解決的問題苍姜,以及它存在的原因牢酵。
這些注釋和文檔還得與時(shí)俱進(jìn),隨著代碼的發(fā)展而更新衙猪。

我們覺得這些是多余的馍乙,是因?yàn)槲覀兪谴a的作者,
而用戶如果沒有它們垫释,就寸步難行丝格,
我們需要設(shè)計(jì)一條學(xué)習(xí)曲線,讓用戶慢慢的理解我們的意圖棵譬。

商業(yè)級(jí)的軟件服務(wù)需要在編碼之外做出很多額外的努力显蝌,
除了全面的測(cè)試之外,還要有詳盡的注釋和豐富的文檔订咸,
我想這才是和業(yè)余項(xiàng)目的根本區(qū)別吧曼尊。


參考

屋中的大象

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市脏嚷,隨后出現(xiàn)的幾起案子骆撇,更是在濱河造成了極大的恐慌,老刑警劉巖父叙,帶你破解...
    沈念sama閱讀 218,451評(píng)論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件神郊,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡趾唱,警方通過查閱死者的電腦和手機(jī)涌乳,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,172評(píng)論 3 394
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來甜癞,“玉大人夕晓,你說我怎么就攤上這事〈叮” “怎么了运授?”我有些...
    開封第一講書人閱讀 164,782評(píng)論 0 354
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)乔煞。 經(jīng)常有香客問我吁朦,道長(zhǎng),這世上最難降的妖魔是什么渡贾? 我笑而不...
    開封第一講書人閱讀 58,709評(píng)論 1 294
  • 正文 為了忘掉前任逗宜,我火速辦了婚禮,結(jié)果婚禮上空骚,老公的妹妹穿的比我還像新娘纺讲。我一直安慰自己,他們只是感情好囤屹,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,733評(píng)論 6 392
  • 文/花漫 我一把揭開白布熬甚。 她就那樣靜靜地躺著,像睡著了一般肋坚。 火紅的嫁衣襯著肌膚如雪乡括。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,578評(píng)論 1 305
  • 那天智厌,我揣著相機(jī)與錄音诲泌,去河邊找鬼。 笑死铣鹏,一個(gè)胖子當(dāng)著我的面吹牛敷扫,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播诚卸,決...
    沈念sama閱讀 40,320評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼葵第,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了合溺?” 一聲冷哼從身側(cè)響起羹幸,我...
    開封第一講書人閱讀 39,241評(píng)論 0 276
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎辫愉,沒想到半個(gè)月后栅受,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,686評(píng)論 1 314
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡恭朗,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,878評(píng)論 3 336
  • 正文 我和宋清朗相戀三年屏镊,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片痰腮。...
    茶點(diǎn)故事閱讀 39,992評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡而芥,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出膀值,到底是詐尸還是另有隱情棍丐,我是刑警寧澤误辑,帶...
    沈念sama閱讀 35,715評(píng)論 5 346
  • 正文 年R本政府宣布,位于F島的核電站歌逢,受9級(jí)特大地震影響巾钉,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜秘案,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,336評(píng)論 3 330
  • 文/蒙蒙 一砰苍、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧阱高,春花似錦赚导、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,912評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至未舟,卻和暖如春黍少,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背处面。 一陣腳步聲響...
    開封第一講書人閱讀 33,040評(píng)論 1 270
  • 我被黑心中介騙來泰國(guó)打工厂置, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人魂角。 一個(gè)月前我還...
    沈念sama閱讀 48,173評(píng)論 3 370
  • 正文 我出身青樓昵济,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親野揪。 傳聞我的和親對(duì)象是個(gè)殘疾皇子访忿,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,947評(píng)論 2 355

推薦閱讀更多精彩內(nèi)容