淺析.NET中文變量及方法的命名規(guī)則
我們將介紹.NET中文變量及方法的命名規(guī)則，相信通過規(guī)范的.NET中文變量及方法的命名，能令今后的維護開發(fā)工作更加的簡單，也方便復用。
目前，我們在項目中使用.NET中文變量，從3年前的權(quán)限管理，到一年前的購物車管理，發(fā)展到了在類庫（會員積分獎金規(guī)則）中使用。體會到了中文變量對于項目維護的巨大方便。現(xiàn)在，我們在枚舉中基本使用中文。他的意義以及對我們的好處，在上篇博文中有說明，請參考 http://www.cnblogs.com/DotLee/archive/2009/08/19/1549750.html。
前提：開發(fā)團隊以中文為主，開發(fā)文檔以中文為主，系統(tǒng)的業(yè)務維護以中文為主，開發(fā)環(huán)境以中文為主。部署環(huán)境無關緊要，如果部署環(huán)境是非中文的，要提前在部署環(huán)境中測試。 建議，***開發(fā)與部署環(huán)境相同。以便于提高項目的工作效率。
變量的命名規(guī)則： 如： private float c1_購物車_非換購商品總額 = 0; 形式：（英文或拼音）字母前綴+數(shù)字+下劃線+字母前綴的中文名稱+下劃線+變量的名稱；(英文cart) c1 _購物車 _ 非換購商品總額 這里： 1表示類中的成員變量,建議字母前綴用小寫2表示類中的方法， 建議字母前綴用大寫3表示方法中的局部變量； 建議字母前綴用小寫枚舉類型的沒有數(shù)字 如：
- private void C2_購物車()
- {...}
- private void C2_購物車()
- {
- string c3_購物車編號 = WebUtils.GetShoppingCartId();
- }
- public enum OrderStateEnum
- {
- os_訂單狀態(tài)_待處理訂單=1,
- os_訂單狀態(tài)_已付款訂單 = 2,
- os_訂單狀態(tài)_已收款訂單 = 3,
- os_訂單狀態(tài)_已發(fā)貨訂單 = 4,
- os_訂單狀態(tài)_已收貨訂單 = 5,
- os_訂單狀態(tài)_已完成訂單 = 6
- }
- public bool PB2_積分獎金_加入積分獎金池(int orderid)
- {
- ...
- bool pb3_積分獎金_加入積分獎金池是否成功 = true;
- ...
- pb3_積分獎金_訂單明細.UO_state = (int)b2cCityBLL.OrderStateEnum.os_訂單狀態(tài)_已完成訂單;
- new b2cCityBLL.OrderBLL().UpdateOrder(pb1_積分獎金_訂單明細 );
- ...
- return pb3_積分獎金_加入積分獎金池是否成功;
- }
這里 pb表示PointsBonus積分獎金,我們對前綴的使用絕大多數(shù)使用英文。前綴的字符數(shù)一般不超過3個。 因為他們分布在不同的命名空間里，所以不會重復。而且，他們的規(guī)則以簡單適用為***，來滿足我們的90%的網(wǎng)站項目。其他的10%,一般而言，不是我們的主要所在。我們的70%的精力，是用在以后項目的維護上，而不是開發(fā)上。也就是以維護項目為主（70%），開發(fā)新項目為輔（30%），這樣，我們的項目功能模塊的復用率很高，相應的開發(fā)效率也就提高了。
這樣，通過前綴可以得到ide的智能提示功能，并且相關的變量會排序在一起；中文的名稱要與業(yè)務員進行溝通，取得一致意見。
缺點，主要是中文的輸入還存在一定的問題，但對于整個項目的好處來說，可以忽略。
這是我們3年多開發(fā)項目中使用中文變量的經(jīng)驗體會。證明他適用于我們，所以我們在這些經(jīng)驗的基礎之上，把對中文變量的使用，逐步的擴大范圍。我們的開發(fā)流程，主要以msf為主，這對于我們來說，也是我們目前的***的實踐吧。
原文標題：我們在dotnet開發(fā)里中文變量及方法的命名規(guī)則
鏈接：http://www.cnblogs.com/DotLee/archive/2009/09/19/1570069.html
【編輯推薦】
