其中的原因很多，我自己歸納了幾點： 1.怕煩 程式設計師從入門之日起，就在心裡埋藏了一顆程式設計的種子，認為程式設計師就是程式設計序的，就是和計算機打交道的，程式就是程式設計師的全部。無論是在程式設計之前寫文件，還是在程式設計之後寫文件。他們都認為寫文件很煩人。 1）文件種類太多。越正規越多。一想到要寫那麼多的文件，程式設計師的頭都要大了。 2）文件寫作要求不低。有格式要求、內容要求，還需要畫各種流程圖、示意圖、關係圖、介面圖和填寫各種表格說明，以及要收集各種資料。雖然沒有技術含量，但是要花的時間比程式設計序多，而且也不一定能寫好。 3）在正規的開發公司中一般一個變更就要編寫一系列的變更文件。當不斷變更時，只有最後的變更文件是最重要的。當我們不知道當前是不是最後一個文件時，我們就不願意寫可能被後面的文件替代的文件。 4）當寫了文件之後，就會不斷有使用文件的人來詢問細節，這些詢問往往會讓人崩潰。這是因為很難寫出讓每個人都提不出問題的文件。 2.沒空 在很多情況下，程式設計師都處於一種“時間緊、任務重”狀態。在急於得出程式設計結果的驅使下，程式設計師一心撲在程式設計上，恨不得一分鐘一個變化，哪有心思和時間先把文件寫好再去程式設計呢？即使他們擁有先把程式編出來，然後再補寫文件的想法，但是一旦他們完成一段程式之後，就會立即撲向第二段程式。如此下來，編寫文件只能放在專案開發的後期了。你要是真的寫文件，那寫文件的時間早已將程式設計時間給擠佔了，你的程式設計工作就完不成了。 3.沒有用 文件的重要性其實對不同物件是不一樣的。如果你說文件沒有用，立即會有人用唾沫把你淹死，他們立即會搬出哪個哪個說文件是重要的，文件是不可缺的。唯獨不敢說“我自己認為文件是重要的”。這也反過來說明文件的有用性程度對不同人是不一樣的。對於程式設計師來說，只要能把程式編出來就行了。很多程式設計師不寫文件照樣編出程式來，在他們的觀念中文件不寫也罷。如果按文件程式設計序，那就要確保文件的正確性、不可更改性。而實際上，文件不如程式設計快，程式設計不如變化快，不斷變化的需求和程式碼讓文件如同一張過時的廢紙一樣。 在現實中，有的文件變成了專案開發後的總結，對開發本身並不起作用，只是保留一個存在的形式，以應付各種各樣規範的需要。在這種情況下，文件沒有任何實用價值，所以即使程式設計師寫了，也沒有什麼作用。尤其是專案投產後，幾經升級，最初的文件早已和現實的情況對不上號了，文件更新和系統的一致性更是難於控制。 4.沒好處 既然認為程式設計序才是正道，那麼程式設計師寫文件就是一種額外和輔助的工作，做了就做了，對於程式設計師來說沒有任何好處。 當然，文件的好處更多地體現在軟體公司、單位、軟體使用者、後續程式設計師身上，它是一種“前人栽樹，後人乘涼”的好事。所以程式設計師不願意寫文件。 文件有多麼重要呢？有人把它上升到“程式設計師頭腦的複製”的高度，有的人甚至說，程式設計師走了後，只要有了文件，軟體公司可以再招新人，公司照樣運轉起來。如此說來，天性聰明的程式設計師會把文件寫得清清楚楚嗎？ 5.不會寫 從寫作本身來看，寫好一篇文件不是一件容易的事。文件有文件的格式和寫作要求。現在的人只喜歡動嘴說事，沒有多少人在平時會動筆寫字，更不用說寫文章了。所以，寫文件從理論上來說也是需要學習和訓練的，需要在平時進行寫作積累。當要求一些程式設計師寫文件的時候，他往往會回答你：“怎麼寫呀？我不會。”你不會寫可以不怪你，你不去學，反而理直氣壯地說不會，則是你的不對了。難道那些會寫文件的人都是“呆子”嗎？難道他們不懂幹活辛苦的道理嗎？ 當一個男子向一個自己喜歡的女子示愛，需要用情書來表白的時候，難道他不會寫情書嗎？即使他不會寫，他也一定會克服千難萬險把情書寫出來的，這是他的主觀使然。如果程式設計師主觀上想寫文件，怎麼會怕煩？怎麼會怕沒空？怎麼會怕文件沒有用？怎麼會怕不會寫？這些怕其實都是藉口。真正優秀的程式設計師應該不單是程式設計的高手，同時也應該是寫文件的高手。 程式設計師真正不喜歡寫文件的原因是：文件是給別人看的，不是給自己看的。如果要使程式設計師喜歡寫文件，那就要提高程式設計師的意識和境界，或者要給寫文件的程式設計師以獎勵。而靠制度、管理讓程式設計師去寫文件只能是一種職業上的弊端。當有一天寫文件也成為一個專業化的崗位，程式設計師和文件人員分開時，程式設計師就會一心一意看文件寫程式碼，文件員就會以此為職業，一心一意寫文件拿工資。我們將不再為此進行討論。這種分工一定是未來的趨勢。一些大的公司或管理規範的公司都已經有這樣的分工了。只是很多中小軟體公司或企事業單位裡的IT部門還沒有專業化到如此程度。程式設計師不喜歡寫文件也許說明他們不願意承擔太多的角色吧。 不管怎麼說，作為一個程式設計師（尤其想成為優秀程式設計師）一定要學會寫文件，一定要學會欣賞文件。無論你是否喜歡，你都應該可以在文件的各種問題面前可進可退。可以這樣說，那些既不會寫文件，又不會欣賞文件的程式設計師是沒有資格說“我就不喜歡寫文件”這種話的。
其中的原因很多，我自己歸納了幾點： 1.怕煩 程式設計師從入門之日起，就在心裡埋藏了一顆程式設計的種子，認為程式設計師就是程式設計序的，就是和計算機打交道的，程式就是程式設計師的全部。無論是在程式設計之前寫文件，還是在程式設計之後寫文件。他們都認為寫文件很煩人。 1）文件種類太多。越正規越多。一想到要寫那麼多的文件，程式設計師的頭都要大了。 2）文件寫作要求不低。有格式要求、內容要求，還需要畫各種流程圖、示意圖、關係圖、介面圖和填寫各種表格說明，以及要收集各種資料。雖然沒有技術含量，但是要花的時間比程式設計序多，而且也不一定能寫好。 3）在正規的開發公司中一般一個變更就要編寫一系列的變更文件。當不斷變更時，只有最後的變更文件是最重要的。當我們不知道當前是不是最後一個文件時，我們就不願意寫可能被後面的文件替代的文件。 4）當寫了文件之後，就會不斷有使用文件的人來詢問細節，這些詢問往往會讓人崩潰。這是因為很難寫出讓每個人都提不出問題的文件。 2.沒空 在很多情況下，程式設計師都處於一種“時間緊、任務重”狀態。在急於得出程式設計結果的驅使下，程式設計師一心撲在程式設計上，恨不得一分鐘一個變化，哪有心思和時間先把文件寫好再去程式設計呢？即使他們擁有先把程式編出來，然後再補寫文件的想法，但是一旦他們完成一段程式之後，就會立即撲向第二段程式。如此下來，編寫文件只能放在專案開發的後期了。你要是真的寫文件，那寫文件的時間早已將程式設計時間給擠佔了，你的程式設計工作就完不成了。 3.沒有用 文件的重要性其實對不同物件是不一樣的。如果你說文件沒有用，立即會有人用唾沫把你淹死，他們立即會搬出哪個哪個說文件是重要的，文件是不可缺的。唯獨不敢說“我自己認為文件是重要的”。這也反過來說明文件的有用性程度對不同人是不一樣的。對於程式設計師來說，只要能把程式編出來就行了。很多程式設計師不寫文件照樣編出程式來，在他們的觀念中文件不寫也罷。如果按文件程式設計序，那就要確保文件的正確性、不可更改性。而實際上，文件不如程式設計快，程式設計不如變化快，不斷變化的需求和程式碼讓文件如同一張過時的廢紙一樣。 在現實中，有的文件變成了專案開發後的總結，對開發本身並不起作用，只是保留一個存在的形式，以應付各種各樣規範的需要。在這種情況下，文件沒有任何實用價值，所以即使程式設計師寫了，也沒有什麼作用。尤其是專案投產後，幾經升級，最初的文件早已和現實的情況對不上號了，文件更新和系統的一致性更是難於控制。 4.沒好處 既然認為程式設計序才是正道，那麼程式設計師寫文件就是一種額外和輔助的工作，做了就做了，對於程式設計師來說沒有任何好處。 當然，文件的好處更多地體現在軟體公司、單位、軟體使用者、後續程式設計師身上，它是一種“前人栽樹，後人乘涼”的好事。所以程式設計師不願意寫文件。 文件有多麼重要呢？有人把它上升到“程式設計師頭腦的複製”的高度，有的人甚至說，程式設計師走了後，只要有了文件，軟體公司可以再招新人，公司照樣運轉起來。如此說來，天性聰明的程式設計師會把文件寫得清清楚楚嗎？ 5.不會寫 從寫作本身來看，寫好一篇文件不是一件容易的事。文件有文件的格式和寫作要求。現在的人只喜歡動嘴說事，沒有多少人在平時會動筆寫字，更不用說寫文章了。所以，寫文件從理論上來說也是需要學習和訓練的，需要在平時進行寫作積累。當要求一些程式設計師寫文件的時候，他往往會回答你：“怎麼寫呀？我不會。”你不會寫可以不怪你，你不去學，反而理直氣壯地說不會，則是你的不對了。難道那些會寫文件的人都是“呆子”嗎？難道他們不懂幹活辛苦的道理嗎？ 當一個男子向一個自己喜歡的女子示愛，需要用情書來表白的時候，難道他不會寫情書嗎？即使他不會寫，他也一定會克服千難萬險把情書寫出來的，這是他的主觀使然。如果程式設計師主觀上想寫文件，怎麼會怕煩？怎麼會怕沒空？怎麼會怕文件沒有用？怎麼會怕不會寫？這些怕其實都是藉口。真正優秀的程式設計師應該不單是程式設計的高手，同時也應該是寫文件的高手。 程式設計師真正不喜歡寫文件的原因是：文件是給別人看的，不是給自己看的。如果要使程式設計師喜歡寫文件，那就要提高程式設計師的意識和境界，或者要給寫文件的程式設計師以獎勵。而靠制度、管理讓程式設計師去寫文件只能是一種職業上的弊端。當有一天寫文件也成為一個專業化的崗位，程式設計師和文件人員分開時，程式設計師就會一心一意看文件寫程式碼，文件員就會以此為職業，一心一意寫文件拿工資。我們將不再為此進行討論。這種分工一定是未來的趨勢。一些大的公司或管理規範的公司都已經有這樣的分工了。只是很多中小軟體公司或企事業單位裡的IT部門還沒有專業化到如此程度。程式設計師不喜歡寫文件也許說明他們不願意承擔太多的角色吧。 不管怎麼說，作為一個程式設計師（尤其想成為優秀程式設計師）一定要學會寫文件，一定要學會欣賞文件。無論你是否喜歡，你都應該可以在文件的各種問題面前可進可退。可以這樣說，那些既不會寫文件，又不會欣賞文件的程式設計師是沒有資格說“我就不喜歡寫文件”這種話的。