摘要:
規范的編碼風格不僅體現了一個人的技術水平,從某種意義上說也體現了一個企業的形象。好的、規范的編碼風格,對于整個項目團隊來說顯得尤為重要。本系列文章對于“編碼風格”的說明僅做參考,希望能對你有所幫助。 閱讀全文
posted @ 2011-03-18 21:00
.NET快速開發框架
閱讀(4427)
評論(9)
推薦(8)
摘要:
“程序員、程序員”顧名思義就是來編程序的人員。他們和一般工作人員是一樣的,都需要合作,可能為了一個大型項目程序會有十人以上或者百人以上甚至千人以上的團隊公司在一起工作。編碼規范使程序規范化,易懂化,才能更好的進行合作。
開發程序的軟件很多。但是它們的檢查方式全是檢查語法,并沒有規定變量命名以及方法的命名,所以注釋是很必要的東西,不過如果你將變量命名的規范一些。 Java和C#里的命名是最接近自然語言的 缺點是名字太長,你不喜歡你的老板,但是你得從老板手里賺錢,這就是道理。
喜歡是一回事,賺錢是另外一回事,找既喜歡,又賺錢的事情做,太難了。命名其實是越長越好的,因為表意性很好,大家看了像看文章一樣,一目了然。這樣才會使得別人更加明白清晰的看清你寫程序的思路。
很多人忌諱寫長名字,主要原因,可能還是怕敲起來麻煩。現在我們在學校用的visual studio 2005其實有很方便的拷貝功能,事實上,我的變量名,函數名,都只敲一遍,以后全部是拷貝+粘貼。
這樣還有一個好處,就是我寫的代碼,永遠不會有筆誤,不會因為我敲錯一個字符而導 閱讀全文
posted @ 2011-03-18 20:49
.NET快速開發框架
閱讀(2359)
評論(0)
推薦(1)
摘要:
2.1 列寬
代碼列寬控制在110字符左右。
2.2 換行
當表達式超出或即將超出規定的列寬,遵循以下規則進行換行
1、在逗號后換行;
2、在操作符前換行;
3、規則1優先于規則2。
2.3 縮進
縮進應該是每行一個Tab(4個空格),不要在代碼中使用Tab字符。 閱讀全文
posted @ 2011-03-18 20:45
.NET快速開發框架
閱讀(1824)
評論(1)
推薦(1)
摘要:
3.1 注釋概述
1、修改代碼時,總是使代碼周圍的注釋保持最新。
2、在每個例程的開始,提供標準的注釋樣本以指示例程的用途、假設和限制很有幫助。注釋樣本應該是解釋它為什么存在和可以做什么的簡短介紹.
3、避免在代碼行的末尾添加注釋;行尾注釋使代碼更難閱讀。不過在批注變量聲明時,行尾注釋是合適的;在這種情況下,將所有行尾注釋在公共制表位處對齊。
4 、避免雜亂的注釋,如一整行星號。而是應該使用空白將注釋同代碼分開。
5 、避免在塊注釋的周圍加上印刷框。這樣看起來可能很漂亮,但是難于維護。
6 、在部署發布之前,移除所有臨時或無關的注釋,以避免在日后的維護工作中產生混亂。
7 、如果需要用注釋來解釋復雜的代碼節,請檢查此代碼以確定是否應該重寫它。盡一切可能不注釋難以理解的代碼,而應該重寫它。盡管一般不應該為了使代碼更簡單以便于人們使用而犧牲性能,但必須保持性能和可維護性之間的平衡。
8 、在編寫注釋時使用完整的句子。注釋應該闡明代碼,而不應該增加多義性。
9 、在編寫代碼時就注釋,因為以后很可能沒有時間這樣做。另外,如果有機會復 閱讀全文
posted @ 2011-03-18 20:41
.NET快速開發框架
閱讀(2491)
評論(0)
推薦(0)
摘要:
4.1 每行聲明數
一行只作一個聲明,如
int level; //推薦
int size; //推薦
int x, y; //不推薦
4.2 初始化
建議在變量聲明時就對其做初始化。 閱讀全文
posted @ 2011-03-18 20:37
.NET快速開發框架
閱讀(935)
評論(0)
推薦(0)
摘要:
5.1 命名概述
名稱應該說明“什么”而不是“如何”。通過避免使用公開基礎實現(它們會發生改變)的名稱,可以保留簡化復雜性的抽象層。例如,可以使用 GetNextStudent(),而不是 GetNextArrayElement()。
命名原則是:
選擇正確名稱時的困難可能表明需要進一步分析或定義項的目的。使名稱足夠長以便有一定的意義,并且足夠短以避免冗長。唯一名稱在編程上僅用于將各項區分開。表現力強的名稱是為了幫助人們閱讀;因此,提供人們可以理解的名稱是有意義的。不過,請確保選擇的名稱符合適用語言的規則和標準。
以下幾點是推薦的命名方法。
1、避免容易被主觀解釋的難懂的名稱,如方面名 AnalyzeThis(),或者屬性名 xxK8。這樣的名稱會導致多義性。
2、在類屬性的名稱中包含類名是多余的,如 Book.BookTitle。而是應該使用 Book.Title。
3、只要合適,在變量名的末尾或開頭加計算限定符(Avg、Sum、Min、Max、Index)。
4、在變量名中使用互補對,如 min/max、begin/end 和 open 閱讀全文
posted @ 2011-03-18 20:33
.NET快速開發框架
閱讀(2846)
評論(0)
推薦(2)
摘要:
6.1 每行一個語句
每行最多包含一個語句。如
a++; //推薦
b--; //推薦
a++; b--; //不推薦
6.2 復合語句
復合語句是指包含"父語句{子語句;子語句;}"的語句,使用復合語句應遵循以下幾點
1 、子語句要縮進。
2 、左花括號“{” 在復合語句父語句的下一行并與之對齊,單獨成行。
3 、即使只有一條子語句要不要省略花括號“ {}”。 如
while (d + = s++)
{
n++;
} 閱讀全文
posted @ 2011-03-18 20:24
.NET快速開發框架
閱讀(1026)
評論(0)
推薦(0)
摘要:
7.1 命名方法
控件名簡寫+英文描述,英文描述首字母大寫 閱讀全文
posted @ 2011-03-18 20:18
.NET快速開發框架
閱讀(1298)
評論(0)
推薦(0)
摘要:
代碼格式檢查使用微軟內部代碼檢查工具 StyleCop 版本4.3.2.1,它會根據預定義的C#代碼格式的最佳實踐,對源代碼進行檢查,并給出不符合編碼風格的錯誤提示(版本語言英文)。
8.1 檢查分類
檢查規則分為7個部分,分別是
“文檔規則(Documentation Rules)”
“布局規則(LayoutRules)”
“可維護性規則(Maintanability Rules)”
“命名規則(Naming Rules)”
“代碼順序規則(Ordering Rules)”
“可讀性規則(Readability Rules)”
“間距規則(Spacing Rules)” 閱讀全文
posted @ 2011-03-18 20:13
.NET快速開發框架
閱讀(2313)
評論(0)
推薦(0)
摘要:
使用Visual Studio自身的代碼分析功能,檢查內容如下表,分為
1.安全規則。
2.互操作性規則
3.可維護性規則
4.可以只性規則
5.命名規則
6.全球化規則
7.設計規則
8.性能規則
9.移動性規則
10.用法規則
其中“是否檢查”一項中為“√”的內容不能違反。需在Visual Studio中設置為錯誤 閱讀全文
posted @ 2011-03-18 20:02
.NET快速開發框架
閱讀(1658)
評論(0)
推薦(2)
摘要:
信息系統項目管理系列之三:項目管理過程發布日期:2011年3月18日星期三作者:EricHu 說明:本文屬作者的讀書筆記。 勤能補拙、笨鳥先飛。 項目管理是一項整體的努力。項目管理的整體性要求每一個項目和產品過程同其他過程恰當地配合與聯系起來,只有這樣才便于協調。過程就是一組為了完成一系列事先... 閱讀全文
posted @ 2011-03-18 15:27
.NET快速開發框架
閱讀(789)
評論(0)
推薦(1)
摘要:
項目管理是一項整體的努力。項目管理的整體性要求每一個項目和產品過程同其他過程恰當地配合與聯系起來,只有這樣才便于協調。
過程就是一組為了完成一系列事先指定的產品、成果或服務而須執行的互相聯系的行動和活動。
在項目管理領域,項目管理的五個項目過程組具有明確的依存關系并在各個項目中按一定的秩序執行。這五大過程組是: 閱讀全文
posted @ 2011-03-18 15:19
.NET快速開發框架
閱讀(619)
評論(0)
推薦(0)

浙公網安備 33010602011771號