<dd id="saiiy"></dd>
  1. <s id="saiiy"></s>

    1. <s id="saiiy"></s>
      1. <span id="saiiy"><blockquote id="saiiy"></blockquote></span>

        軟件開(kāi)發(fā)編碼規范

        發(fā)布時(shí)間:2025-05-24 13:34:30   來(lái)源:黨團工作    點(diǎn)擊:   
        字號:

         軟 件 開(kāi) 發(fā) 編 碼 規 范(C#)

          目

          錄 1 引言 ......................................................................................................................................... 3 1.1 編寫(xiě)目的 .................................................................................................................. 3 1.2 背景 .......................................................................................................................... 3 1.3 定義 .......................................................................................................................... 3 1.4 參考資料 .................................................................................................................. 3 2 基本要求.................................................................................................................................. 3 2.1 程序結構要求 .......................................................................................................... 3 2.2 可讀性要求 .............................................................................................................. 3 2.3 結構化要求 .............................................................................................................. 4 2.4 正確性與容錯性要求 .............................................................................................. 4 2.5 可重用性要求 .......................................................................................................... 5 3 用戶(hù)界面設計原則 .................................................................................................................. 5 4 源程序書(shū)寫(xiě)規范 ...................................................................................................................... 5 4.1 通用源代碼格式規則 .............................................................................................. 5 4.1.1 縮進(jìn) .................................................................................................................. 5 4.1.2 邊距 .................................................................................................................. 6 4.1.3 “{}”的使用 .................................................................................................... 6 4.1.4 注釋 .................................................................................................................. 6 4.2 語(yǔ)句格式與語(yǔ)句書(shū)寫(xiě)規范 ...................................................................................... 6 4.2.1 括號 .................................................................................................................. 6 4.2.2 保留字和關(guān)鍵字 .............................................................................................. 7 4.2.3 函數 .................................................................................................................. 7 4.2.4 變量 .................................................................................................................. 7 4.2.5 語(yǔ)句 .................................................................................................................. 7 5 命名規范.................................................................................................................................. 9 5.1 函數命名 .................................................................................................................. 9 5.2 形參 .......................................................................................................................... 9 5.3 常量和變量 .............................................................................................................. 9 5.3.1 常量和宏定義 .................................................................................................. 9 5.3.2 變量 .................................................................................................................. 9 5.4 函數使用說(shuō)明、接口命名、NameSpace 命名 .................................................... 10 5.5 控件的命名 ............................................................................................................ 11 5.6 類(lèi)型 ........................................................................................................................ 11 5.6.1 一般類(lèi)型 ........................................................................................................ 11 5.6.2 構造類(lèi)型 ........................................................................................................ 12 5.6.3 類(lèi)類(lèi)型 ............................................................................................................ 12 5.7 文件和文件夾 ........................................................................................................ 12 5.7.1 文件夾的命名規則 ........................................................................................ 12 5.7.2 文件命名 ........................................................................................................ 13 6 源程序文檔注釋規范 ............................................................................................................ 13 6.1 注釋文檔的一般規范 ............................................................................................ 13

         1 1 引言

         1.1 編寫(xiě)目的

         本規范旨在用規范文件的形式, 對全公司使用 C#進(jìn)行的編程過(guò)程, 進(jìn)行有效的規范管理, 使得最終的軟件產(chǎn)品具有良好的風(fēng)格和統一的結構, 且使代碼可讀性強、易維護。

         本規范預期讀者是全公司所有參與編程的軟件開(kāi)發(fā)人員以及其他相關(guān)人員。

         本標準適用于 Visual C# ,其余語(yǔ)言作參考。

          1.2 背景

         公司在上一個(gè)項目中由于代碼編寫(xiě)風(fēng)格不統一, 可讀性較差、較難維護, 使得工作效率有所降低。

          1.3 定義

         無(wú)

          1.4 參考資料

         Pascal Standards FAQ (E) JavaDoc (E)

         Doc-O-matic Document (E) Artemis Alliance Delphi Coding Standards (E) 《C#基本書(shū)寫(xiě)規范》 《C#編碼規范綱要》

          2 2 基本要求

         2.1 程序結構要求

         程序結構清晰, 簡(jiǎn)單易懂, 單個(gè)函數的程序行數一般不得超過(guò) 100 行,個(gè)別特殊函數除外。

         代碼中打算干什么, 要簡(jiǎn)單, 直接了當, 代碼精簡(jiǎn), 避免垃圾程序。

         應盡量使用.NET庫函數和公共函數(無(wú)特殊情況不要使用外部方法調用windows的核心動(dòng)態(tài)鏈接庫)。

         一般情況下, 不得使用全局變量, 盡量使用局部變量。

          2.2 可讀性要求

         可讀性第一, 效率第二。(這僅對代碼本身而言)。

         保持注釋與代碼完全一致。

         每個(gè)源程序文件, 都必須有文件頭說(shuō)明, 說(shuō)明規格見(jiàn)“源程序文檔注釋規范”一節。

         每個(gè)函數, 都必須有函數頭說(shuō)明, 說(shuō)明規格見(jiàn)“源程序文檔注釋規范”一節。

         主要變量(結構、聯(lián)合、類(lèi)或對象)定義或引用時(shí), 注釋必須能反映其物理含義。

         處理過(guò)程的每個(gè)階段都必須有相關(guān)注釋說(shuō)明。

         在典型算法前都必須有注釋, 同時(shí)算法在滿(mǎn)足要求的情況下應盡可能簡(jiǎn)單。

         利用縮進(jìn)來(lái)顯示程序的邏輯結構, 縮進(jìn)量一致以 Tab 鍵為單位, 定義 Tab 為 4 個(gè) 字節。

         循環(huán)、分支層次不要超過(guò)五層。

         注釋可以與語(yǔ)句在同一行, 也可以在上行。

         空行和空白字符也是一種特殊注釋。

         一目了然的語(yǔ)句不加注釋。

         注釋的作用范圍可以為:定義、引用、條件分支以及一段代碼。

         注釋行數(不包括文件頭和函數頭說(shuō)明部份)應占總行數的 1/5 到 1/3。

         常量定義(const)有相應說(shuō)明。

          2.3 結構化要求

         禁止出現兩條等價(jià)的支路。

         禁止 GOTO 語(yǔ)句。

         用 IF 語(yǔ)句來(lái)強調只執行兩組語(yǔ)句中的一組。禁止 ELSE GOTO 和 ELSE RETURN。

         用 CASE 實(shí)現多路分支。

         避免從循環(huán)引出多個(gè)出口。

         函數只有一個(gè)出口。

         不使用復雜的條件賦值語(yǔ)句。

         避免不必要的分支。

         不要輕易用條件分支去替換邏輯表達式。

          2.4 正確性與容錯性要求

         程序首先是正確, 其次是優(yōu)美。

         無(wú)法證明你的程序沒(méi)有錯誤, 因此在編寫(xiě)完一段程序后, 應先回頭檢查。

         改一個(gè)錯誤時(shí)可能產(chǎn)生新的錯誤, 因此在修改前首先考慮對其它程序的影響。

         所有變量在調用前必須被初始化。

         對所有的用戶(hù)輸入, 必須進(jìn)行合法性檢查。

         不要比較浮點(diǎn)數的相等, 如:

         10.0 * 0.1 == 1.0 ,

         不可靠。

         程序與環(huán)境或狀態(tài)發(fā)生關(guān)系時(shí), 必須主動(dòng)去處理發(fā)生的意外事件, 如文件能否邏輯鎖定、打印機是否聯(lián)機等,對于明確的錯誤,要有明確的容錯代碼提示用戶(hù)。

         單元測試也是編程的一部份, 提交聯(lián)調測試的程序必須通過(guò)單元測試。

         盡量使用規范的容錯語(yǔ)句。

         例如: try { } catch

         { } finally { }

         2.5 可重用性要求

         重復使用的完成相對獨立功能的算法或代碼應抽象為服務(wù)或類(lèi)。

         服務(wù)或類(lèi)應考慮面向對象(OO)思想, 減少外界聯(lián)系, 考慮獨立性或封裝性。

          3 3 用戶(hù)界面設計原則

         除標題部分外, 所有顯示給用戶(hù)的字體(如BUTTON和LABEL等)使用標準字體:宋 體、九號、黑色;標題部分可用醒目的字體, 如:宋體、小二號、紅色。

         采用Windows缺省的風(fēng)格。

         窗體盡量從已有的父窗體繼承。

         方便用戶(hù)對信息的輸入、修改和閱讀。

         驗證用戶(hù)輸入的有效性和合理性。

         具有清晰明確的用戶(hù)提示信息。

         使用Tab鍵在輸入項之間移動(dòng)輸入焦點(diǎn)(可選)。

         標準按鈕大小必須相同, 使用的圖像和標題必須與《界面風(fēng)格規范》一致, 如果出現該規范中沒(méi)有的地方, 須與項目負責人和美工協(xié)商。

         4 4 源程序書(shū)寫(xiě)規范

         4.1 通用源代碼格式規則

         4.1.1 縮進(jìn) 縮進(jìn)就是每級間有一個(gè) Tab 單位。不要在源代碼中放置制表符。這是因為, 制表符的寬度隨著(zhù)不同的設置和代碼管理實(shí)用程序(打印、文檔及版本控制等)而不同。

         沿邏輯結構行縮進(jìn)代碼。沒(méi)有縮進(jìn), 代碼將變得難以理解, 如:

          if(expression )

          {

          //

          //此處填寫(xiě)你的代碼塊;

          //

          }

          if(expression )

          {

          //

          //此處填寫(xiě)你的代碼塊;

          //

          }

         else

          {

          //

          //此處填寫(xiě)你的代碼塊;

          // }

         縮進(jìn)代碼會(huì )產(chǎn)生出更容易閱讀的代碼, 如:

         if(expression )

         { if(expression )

         {

          //

          //此處填寫(xiě)你的代碼塊;

          //

         }

         else

         {

          //

          //此處填寫(xiě)你的代碼塊;

          //

         }

          }

         4.1.2 邊距

         邊距設置為 80 個(gè)字符。源代碼一般不會(huì )因寫(xiě)一個(gè)單詞而超過(guò)邊距, 但本規則比較靈活。只要可能, 長(cháng)度超過(guò)一行的語(yǔ)句應當用分行符換行。換行后, 應縮進(jìn)兩個(gè)字符。

          4.1.3 “{} ”的使用 “{”或“}”必須單獨占一行。例如:

         錯誤形式:

         for(i:=0;i<10;i++){ // 錯, “{” 與 f o r 在同一行

         }

          正確形式:

         for(i:=0;i<10;i++)

         // 對, “{”在另外一行中 { }

         4.1.4 注釋 通常使用“/*...*/”類(lèi)型的塊注釋和“//”類(lèi)型的行注釋。

          4.2 語(yǔ)句格式與語(yǔ)句書(shū)寫(xiě)規范

         4.2.1 括號

          在左括號與下一字符之間沒(méi)有空格。同樣, 右括號與前一字符也沒(méi)有空格。下面的例子演示了正確與不正確的空格。

         CallProc( aParameter ); // 錯!

         CallProc(aParameter); // 正確!

          4.2.2 保留字和關(guān)鍵字 在用戶(hù)的各種命名中不能單獨使用保留字或關(guān)鍵字來(lái)進(jìn)行命名。

         4.2.3 函數 4.2.3.1 格式

         函數名要能體現出該函數要實(shí)現的功能, 應當以大寫(xiě)字母開(kāi)始, 且大小寫(xiě)交錯以增加可讀性(每個(gè)單詞的首字母大寫(xiě))。下面是一個(gè)不正確的寫(xiě)法:

         pubilc void thisisapoorlyformattedroutinename() 下面是正確的寫(xiě)法:

         pubilc void ThisIsMuchMoreReadableRoutineName()

         4.2.3.2 形參

         1 1 )

         參數順序

          形參的順序主要要考慮寄存器調用規則。最常用的參數應當作為第一個(gè)參數, 按使用頻率依次從左到右排。輸入參數位于輸出參數之前。范圍大的參數應當放在范圍小的參數之前。例如:

         SomeProc(aPlanet, aContinent, aCountry, aState, aCity).

          有些則例外。例如, 在事件處理過(guò)程中, Object 類(lèi)型的 Sender 參數往往是第一個(gè)要傳遞的參數。

         2 2 )

         常量參數

          任何值類(lèi)型參數, 只要不加REF標志, 都是常量參數; 任何引用類(lèi)型參數, 都不是常量參數, 不管加不加標志。

          4.2.4 變量 4.2.4.1 局部變量

          局部變量用于過(guò)程內部, 如果需要的話(huà), 應當在過(guò)程的入口處立即初始化變量。

         4.2.4.2 全局變量

         一般不鼓勵使用全局變量。不過(guò), 有時(shí)候需要用到。即使如此, 也應當把全局變量限制在需要的環(huán)境中。例如, 一個(gè)全局變量可能只在單元的實(shí)現部分是全局的。

          全局數據如果將由許多單元使用, 就應移動(dòng)到一個(gè)公用單元里被所有對象使用。全局數據可在聲明時(shí)直接初始化為一個(gè)值。

          4.2.5 語(yǔ)句 4.2.5.1 If 語(yǔ)句

         在 if/else 語(yǔ)句中,

         if 子句的條件應該直接且易于理解。為了避免出現許多 if 語(yǔ)句, 可以使用 switch 語(yǔ)句代替。如果多于 5 級, 不要使用 if 語(yǔ)句。請改用更清楚的方法。

         如果在 if 語(yǔ)句中有多個(gè)條件要測試, 應按照計算的復雜程度從右向左排。這樣, 可以使代碼充分利用編譯器的短路估算邏輯。例如, 如果 Condition1 比 Condition2 快, Condition2 比 Condition3 快, 則 if 語(yǔ)句一般應這樣構造:

         if (Condition1 && Condition2 && Condition3)

         如果 Condition3 為 False 的機會(huì )很大, 利用短路估算邏輯, 我們也可以將Condition3 放在最前面:

         if (Condition3 && Condition1 && Condition2)

          有 if 出現,就必須有對應的 else 出現。if 語(yǔ)句的三種形式: 1) 形式一(不需要 else)

          if (Condition) {

         Process; } //else //{ //

         No Else Needed //} 2) 形式二(需要 else,但是 else 里面不需要處理)

         if (Condition) {

         Process; } else { //No Need Process } 3) 形式三(if 里面不需要處理)

          if (Condition) { // No Need Process } else { Process; }

         4.2.5.2 switch

         語(yǔ)句

         1 1 )概述

         switch 語(yǔ)句中每種情況的常量應當按數字或字母的順序排列。每種情況的動(dòng)作語(yǔ)句應當簡(jiǎn)短且通常不超過(guò) 4 - 5 行代碼。如果動(dòng)作太復雜, 應將代碼單獨放在一個(gè)函數中。switch 語(yǔ)句的 else 子句只用于默認情況或錯誤檢測。

         2 2 )格式

          switch 語(yǔ)句遵循一般的縮進(jìn)和命名規則。

         4.2.5.3 while 語(yǔ)句

         所有對 while 循環(huán)進(jìn)行初始化的代碼應當位于 while 入口前, 且不要被無(wú)關(guān)的語(yǔ)句隔開(kāi)。任何業(yè)務(wù)的輔助工作都應在循環(huán)后立即進(jìn)行。

         4.2.5.4 for 語(yǔ)句

         如果循環(huán)次數是確定的, 應當用 for 語(yǔ)句代替 while 語(yǔ)句。

         5 5 命名規范

         5.1 函數命名

          函數名應當有意義。進(jìn)行一個(gè)動(dòng)作的函數最好在名稱(chēng)前加上表示動(dòng)作的動(dòng)詞為前綴。例如:

         public void FormatHardDrive()

          設置輸入參數值的函數名應當以 Set 為其前綴, 例如:

         public void SetUserName()

          獲取數值的函數名應當以 Get 為其前綴, 例如:

         public string GetUserName() 函數名稱(chēng)第一個(gè)字母必須使用大寫(xiě)字母,要求用大小寫(xiě)字母組合規范函數命名,必要時(shí)可用下劃線(xiàn)間隔,示例如下:

         public void PrintTrackData() public void ShowChar(int aIndex, char aszMyChar)

          5.2 形參

         所有形參的名稱(chēng)都應當表達出它的用途。如果合適的話(huà), 形參的名稱(chēng)最好以字母 a 為前綴, 例如:

         public void SomeProc(string aUserName, integer aUserAge) 當參數名與類(lèi)的特性或字段同名時(shí), 前綴 a 就有必要了。

          5.3 常量和變量

         5.3.1 常量和宏定義

          常量和宏定義必須具有一定的實(shí)際意義;常量和宏定義必須全部以大寫(xiě)字母,中間可根據意義的連續性用下劃線(xiàn)連接,每一條定義的右側必須有一簡(jiǎn)單的注釋,說(shuō)明其作用。

         資源名字定義格式: 菜單:IDM_XX 或者 CM_XX 位圖:IDB_XX 對話(huà)框:IDD_XX 字符串:IDS_XX DLGINIT:DIALOG_XX ICON:IDR_XX

          5.3.2 變量

         變量命名必須具有一定的實(shí)際意義,形式為 xAbcFgh,x 由變量類(lèi)型確定,Abc、Fgh 表示連續意義字符串,如果連續意義字符串僅兩個(gè),可都大寫(xiě), 如 OK 。

         常用的變量舉例如下:

         以下面字母或符號作為前綴, 分別具有如下意義:

         x,y

         坐標 att

         表屬性 c

          類(lèi)對象 cMain(對象實(shí)例)

         m_

         類(lèi)成員變量 m_nVal, m_bFlag s_

         類(lèi)靜態(tài)成員變量 s_nVal,s_bFlag

          5.3.2.1 局部變量

         局部變量遵循其他變量的命名規則。通常以“n”作為前綴。

         局部變量中可采用如下幾個(gè)通用變量:nTemp, nResult, I, J(一般用于循環(huán)變量)。

         5.3.2.2 全局變量

         全局變量一般以字母“g”打頭, 并遵循其他變量的命名規則。

          5.4 函數使用說(shuō)明、接口命名、e NameSpace 命名

         函數使用說(shuō)明包括外來(lái)函數及內部函數的使用說(shuō)明, 外部引用函數必須在右側注明函數來(lái)源:

         模塊名及文件名, 如是內部函數, 只要注釋“local module”即可。例如:

         strName=GetUserName(strUserId);// local module strName= GetUserName(strUserId);// Module Name:UserManage

          // File Name: fm UserManage

          事件函數的使用說(shuō)明:

         public void EventHandler(object sd,Event e)

         //Event 表示事件響應的函數。

         接口命名:

         縮寫(xiě) 類(lèi)型 舉例 dt DateTime dtText sz char szText sb sbyte sbText bt byte btText n int nText ui uint uiText l long lText ul ulong ulText f float fText d double dText b bool bText de decimal deText str string strText

         接口的命名一般都以“I”作為首字母,為了和類(lèi)區分,例如:

          interface IComnunication

          命名空間:

         命名空間命名規則從原則上和函數命名相同。通常格式如下:

         NameSpace 命名:N + 部署位置 + 項目名稱(chēng)

         + namespace 名稱(chēng)

          其他:

         Application 命名

         P + 部署位置 + 項目名稱(chēng)

         5.5 控件的命名

         C#控件規則為了和.net 類(lèi)庫統一,分 WindowsForm 程序和 Web 程序。下面就這兩部分分別描述。

         1 1 )m WindowsForm 程序

          (用小寫(xiě)前綴表示類(lèi)別)

          fm 窗口 cmd 按鈕 cob combo, 下拉式列表框 txt 文本輸入框 lab labal, 標簽 img image, 圖象 pic picture grd Grid, 網(wǎng)格 scr 滾動(dòng)條 lst 列表框 frm fram 2 2 )b Web 程序

          (用大寫(xiě)前綴表示類(lèi)別)

          Fm 窗口 Cmd 按鈕 Cob combo, 下拉式列表框 Txt 文本輸入框 Lab labal, 標簽 Img image, 圖象 Pic picture Grd Grid, 網(wǎng)格 Scr 滾動(dòng)條 Lst 列表框 Frm fram

          5.6 類(lèi)型

         5.6.1 一般類(lèi)型 5.6.1.1 枚舉型

         枚舉類(lèi)型名必須代表枚舉的用途。枚舉類(lèi)型的標識符列表的前綴應包含 2 - 3 個(gè)小寫(xiě)字符, 來(lái)彼此關(guān)聯(lián)。例如:

         enum SongType={stRock, stClassical, stCountry, stAlternative, stHeavyMetal, stRB};

         5.6.2 構造類(lèi)型 5.6.2.1 數組類(lèi)型

         數組類(lèi)型名應表達出該數組的用途。例如:

         string[] weekDays = new string[7]; 字符串型數組 weekDays 包括 7 個(gè)元素。

          5.6.2.2 結構體類(lèi)型

         結構體類(lèi)型命名必須全部用大寫(xiě)字母,原則上前面以下劃線(xiàn)開(kāi)始;結構體變量命名必須用大小寫(xiě)字母組合, 第一個(gè)字母必須使用大寫(xiě)字母,必要時(shí)可用下劃線(xiàn)間隔。對于私有數據區, 必須注明其所屬的進(jìn)程。全局數據定義只需注意其用途。

         示例如下:

         public struct DBS_DATABASE { char szProductName[20];

          char szAuthor[20];

          char szReleaseDate[16];

          char szVersion[10];

         unsigned long MaxTables;

          unsigned long UsedTables;

          }

          DBS_DATABASE GdataBase;

          5.6.3 類(lèi)類(lèi)型

         5.6.3.1 類(lèi)命名與格式

         類(lèi)的名稱(chēng)應當表達出類(lèi)的用途。一般的類(lèi)名前要加字母“C”, 如果是接口類(lèi)那么類(lèi)名前要加“I”, 錯誤異常類(lèi)的類(lèi)名前要加“E”, 而類(lèi)引用類(lèi)型(Class-reference type)則要在類(lèi)名后加“Class”, 抽象類(lèi)一般是在類(lèi)名前還要加“Abstract”。

         5.6.3.2 屬性命名規則

         屬性的命名遵循與變量相同的規則, 只不過(guò)要加前綴“f”, 表示這是屬性。

          5.6.3.3 方法命名規則

         方法的命名遵循與過(guò)程和函數相同的規則。

          5.7 文件和文件夾

         5.7.1 文件夾的命名規則

          根據系統設計所規定的結構, 建立相應的文件夾, 根據需要建立子文件夾; 文件夾的名稱(chēng)應盡量能夠表達其意義, 盡量使用英文命名;

         文件夾名稱(chēng)遵循本文命名規范。

         5.7.2 文件命名 文件的名稱(chēng)應盡量能夠表達其意義, 盡量英文命名, 不能使用漢字。文件名稱(chēng)遵循本文命名規范。對于各種類(lèi)型的文件主要分以下三大類(lèi)來(lái)描述其命名規則:

         1)窗體文件

          frm+表示窗體意義的詞語(yǔ)或其縮寫(xiě) 2)一般類(lèi)文件

          cls+表示類(lèi)意義的詞語(yǔ)或其縮寫(xiě) 3)控件文件 cn+表示控件意義的詞語(yǔ)或其縮寫(xiě)

         6 6 源程序文檔注釋規范

         書(shū)寫(xiě)注釋的目的主要有二:

         一是為自己以后閱讀源程序提供方便; 二是為建立規范的程序文檔手冊, 提供接口說(shuō)明。

          6.1 注釋文檔的一般規范

         原則上注釋要求使用中文; 文件開(kāi)始注釋內容包括:公司名稱(chēng)、版權、作者名稱(chēng)、時(shí)間、模塊用途、背景介紹等,復雜的算法需要加上流程說(shuō)明; 函數注釋包括:輸入、輸出、函數描述、流程處理、全局變量、調用樣例等,復雜的函數需要加上變量用途說(shuō)明; 程序中注釋包括:修改時(shí)間和作者、方便理解的注釋等;

         例一: 文件開(kāi)頭的注釋模板 /************************************************************** ** 文件名: ** Copyright (c) 1998-1999 *********公司技術(shù)開(kāi)發(fā)部 ** 創(chuàng )建人: ** 日 期: ** 修改人: ** 日 期: ** 描 述: ** ** 版 本: **------------------------------------------------------------------------ *************************************************************/

         例二: 函數開(kāi)頭的注釋模板 復雜的函數應采用如下的模板:

         /************************************************************* ** 函數名: ** 輸 入: a,b,c ** a--- ** b--- ** c--- ** 輸 出: x--- ** x 為 1, 表示... ** x 為 0, 表示... ** 功能描述: ** 全局變量: ** 調用模塊: ** 作 者: ** 日 期: ** 修 改: ** 日 期: ** 版本: *************************************************************/ 簡(jiǎn)單的函數可以采用 C#的標準注釋方法, 如:

         /// <summary> /// 清理所有正在使用的資源。

         /// </summary>

         例三: 程序中的注釋模板 程序中的多行注釋?xiě)捎萌缦伦⑨專(zhuān)?/p>

         /*----------------------------------------------------------*/ /* 注釋內容 */ /*----------------------------------------------------------*/

         以下內容為:

         制定規范的目的和意義

          (一) 標準化為科學(xué)管理奠定了基礎。所謂科學(xué)管理, 就是依據生產(chǎn)技術(shù)的發(fā)展規律和客觀(guān)經(jīng)濟規律對企業(yè)進(jìn)行管理, 而各種科學(xué)管理制度的形式, 都以標準化為基礎。

         (二) 促進(jìn)經(jīng)濟全面發(fā)展, 提高經(jīng)濟效益。標準化應用于科學(xué)研究, 可以避免在研究上的重復勞動(dòng);應用于產(chǎn)品設計, 可以縮短設計周期;應用于生產(chǎn), 可使生產(chǎn)在科學(xué)的和有秩序的基礎上進(jìn)行;應用于管理, 可促進(jìn)統一、協(xié)調、高效率等。

         (三)標準化是科研、生產(chǎn)、使用三者之間的橋梁。一項科研成果, 一旦納入相應標準, 就能迅速得到推廣和應用。因此, 標準化可使新技術(shù)和新科研成果得到推廣應用, 從而促進(jìn)技術(shù)進(jìn)步;

         (四)標準化為組織現代化生產(chǎn)創(chuàng )造了前提條件。

         隨著(zhù)科學(xué)技 術(shù)的發(fā)展, 生產(chǎn)的社會(huì )化程度越來(lái)越高, 生產(chǎn)規模越來(lái)越大, 技術(shù)要求越來(lái)越復雜, 分工越來(lái)越細, 生產(chǎn)協(xié)作越來(lái)越廣泛, 這就必須通過(guò)制定和使用標準, 來(lái)保證各生產(chǎn)部門(mén)的活動(dòng), 在技術(shù)上保持高度的統一和協(xié)調, 以使生產(chǎn)正常進(jìn)行;所以, 我們說(shuō)標準化為組織現代化生產(chǎn)創(chuàng )造了前提條件。

         (五)促進(jìn)對自然資源的合理利用, 保持生態(tài)平衡, 維護人類(lèi)社會(huì )當前和長(cháng)遠的利益。標準化是經(jīng)過(guò)多次實(shí)踐后得出的最為有效的形式, 對于資源的利用率也是比較高的, 所以標準化在資源的合理化利用方面是有著(zhù)積極意義的。

         (六)合理發(fā)展產(chǎn)品品種, 提高企業(yè)應變能力, 以更好的滿(mǎn)足社會(huì )需求。標準化是對當前產(chǎn)品的精煉, 是針對市場(chǎng)需求的的細分, 把最適合的保留下來(lái), 這樣將更好的滿(mǎn)足社會(huì )的需求。

         (七)保證產(chǎn)品質(zhì)量, 維護消費者利益。標準化的規定的程序進(jìn)行, 將人為因素對產(chǎn)品質(zhì)量的影響降到最低, 確保了產(chǎn)品質(zhì)量。

         (八) 在社會(huì )生產(chǎn)組成部分之間進(jìn)行協(xié)調, 確立共同遵循的準則, 建立穩定的秩序。

         標準化的采用, 提高了企業(yè)產(chǎn)品之間的兼容性, 減少了由于企業(yè)產(chǎn)品之間標準不一致, 帶來(lái)的巨大社會(huì )浪費。另外, 企業(yè)通過(guò)標準化可以避免對某一個(gè)供貨商的依賴(lài), 因為其他供貨商依據公開(kāi)的標準可以補充市場(chǎng), 于是企業(yè)的供貨渠道不斷增加。供應商數量的增加, 加大了供貨商之間的競爭, 從而促使產(chǎn)品質(zhì)量不斷提高, 價(jià)格也會(huì )不斷降低, 建維護了市場(chǎng)穩定的秩序

         (九)在消除貿易障礙, 促進(jìn)國際技術(shù)交流和貿易發(fā)展, 提高產(chǎn)品在國際市場(chǎng)上的競爭能力方面具有重大作用。加入 WTO 以來(lái), 面對技術(shù)壁壘, 我國在大力提高產(chǎn)品質(zhì)量的同時(shí), 必須依靠標準化工作提高技術(shù)水平, 提升保障產(chǎn)品質(zhì)量, 才能在國際貿易方面有一定的話(huà)語(yǔ)權, 穩定促進(jìn)國際貿易發(fā)展。

         (十) 保障身體健康和生命安全, 大量的環(huán)保標準、衛生標準和安全標準制定發(fā)布后, 用法律形式強制執行, 對保障人民的身體健康和生命財產(chǎn)安全具有重大作用。

         (十一)標準化標志著(zhù)一個(gè)行業(yè)新的標準的產(chǎn)生。標準化是產(chǎn)品質(zhì)量和技術(shù)發(fā)展一定水平才能實(shí)現的, 標準化實(shí)現將進(jìn)一步促使生產(chǎn)技術(shù)的提高, 進(jìn)行形成更高水平的標準。

         總之, 標準及標準化所具有的引導性、前瞻性、公平性、強制性和懲戒性, 決定了標準化在市場(chǎng)經(jīng)濟中的作用是多層次的、全方位的, 進(jìn)而也決定了

         它是建立和完善市場(chǎng)經(jīng)濟體制不可缺少的重要元素。應用標準化的目的就是為了能有效解決市場(chǎng)經(jīng)濟發(fā)展中的質(zhì)

         量問(wèn)題、效率問(wèn)題、秩序問(wèn)題、可持續發(fā)展問(wèn)題等。因此, 我們必須從戰略的高度重視標準化工作。只有我們不斷地去提升標準化水平, 才能有效提升產(chǎn)品質(zhì)量, 增強產(chǎn)品的市場(chǎng)競爭力, 進(jìn)一步擴大出口貿易, 從而有效推進(jìn)經(jīng)濟社會(huì )又好又快向前發(fā)展。

        国产另类无码专区|日本教师强伦姧在线观|看纯日姘一级毛片|91久久夜色精品国产按摩|337p日本欧洲亚洲大胆精

        <dd id="saiiy"></dd>
        1. <s id="saiiy"></s>

          1. <s id="saiiy"></s>
            1. <span id="saiiy"><blockquote id="saiiy"></blockquote></span>