注釋

1.注釋的定義

注釋的英文是annotation，是指對書籍或文章的語匯、內容、背景、引文作介紹、評議的文字。

2.注釋的起源

注釋起源于先秦時期，在那個時候就有了對古書的注釋。

3.為什么要有注釋

注釋是為了對一些文字的解釋，一些不懂的事物的解釋。

注釋的對象不是自己，因為你自己寫的東西自己肯定自己看的懂。關鍵在于雖然你看得懂，但是比人不一定看得懂。

就比如說古書，你是看懂了，但是別人看不懂，這時候你就需要根據你自己的理解，對一些別人看不懂的地方進行注釋。

再比如說代碼。首先，代碼是你寫的吧，那你自己就是懂得咯。但是呢，別人看不懂怎么辦，你難不成跟每一個看不懂的人解釋一下這句話是干嘛的嗎？這里就需要注釋了，你注釋了，別人就能看懂了。但是注釋你也要盡量描述的清晰，不然就白注釋了。

4.注釋的原則

1）注釋形式統一

在整個應用程序中，使用具有一致的標點和結構的樣式來構造注釋。如果在其它項目中發現它們的注釋規范與這份文檔不同，按照這份規范寫代碼，不要試圖在既成的規范系統中引入新的規范。

2）注釋內容準確簡潔

內容要簡單、明了、含義準確，防止注釋的多義性，錯誤的注釋不但無益反而有害。

6.注釋的快捷鍵

注釋的快捷鍵是“ctrl” + “/”兩個按鈕，這個是單行注釋。首先你需要選中你要注釋的內容，然后先按“ctrl”，在按“/”，然后代碼就會被注釋了。 也可以是使用“ctrl” + “shift” ?+ “/”，這個是多行注釋。這里教你們一個方法，同時按三個的方法：你可以先按住“ctrl”鍵，然后再按“shift” ，最后在按“/”。

5.注釋的條件條件

一般來說，我們不會無緣無故的注釋。因為那樣不僅會增加我們的書寫量，而且也會把代碼變得不簡潔。 基本注釋：全局變量的注釋、函數的注釋、鏈接的注釋、對象的注釋。 特殊注釋：在一些代碼不明處添加注釋。 下通同過案例說明： <div class="header"><!--頭部--><div class="content"><!--內容--><div class="logo"><!--logo--><img src="../img/logo.png" alt="logo圖片"/></div><div class="nav1"><!--導航欄--><ul><li><a href="index.html" target="_self">首頁</a></li><li><a href="download_app.html">app下載</a></li><li><a href="about.html">關于我們</a></li><li><a href="partner_apply.html">招商</a></li><li class="phone">400-1234-123</li></ul></div></div> </div><!--頭部-->
上面是一個HTML界面的編寫，他添加了好多注釋，讓我們一看就看的懂，好理解。
記住，一個不會注釋的碼農不是一個好的程序員，一個沒有注釋的代碼塊不是一個好的代碼塊。

6.注釋分類

注釋有多種：

1）在HTML中的注釋：

格式是<!--內容-->,內容寫在中間，這個可以單行注釋，也可以是多行注釋。

<!--1.這是HTML中的單行注釋--> <!--2.這個是第二行-->

也可以這樣一起注釋，

<!--1.這個HTML中的多行注釋 2.這個是第二行-->

這樣都是可以實行注釋的。

2）在css中的注釋：

格式是/*內容*/，內容也是寫在中間，也是可以單行和多行注釋。

/*1.這個是在css中的單行注釋 2.這是第二行*/

/*1.這個是在css中的多行注釋*/ /*2.這是第二行*/

3)在js中的注釋：

這個js中的注釋比較特別，他有兩種格式：分別是單行注釋和多行注釋。單行和多行注釋使用的符號不一樣。

首先是單行注釋，這個注釋格式是//，兩個斜杠。代表的是該行斜杠后面的內容被注釋了。

//1.這個是在js中的單行注釋 //2.這是第二行

下面是多行注釋，注釋格式與css一樣，使用的也是/*內容*/形式。

/*1.這個是在js中的多行注釋 2.這是第二行*/

在java中注釋與js的注釋一樣，使用的方法也是相同的的。

7.注釋的特點

在代碼中注釋還有別的意義。他可以注釋你所寫的代碼，然后你注釋的代碼就不會執行。
var sum = 0;sum+=1;sum+=2;/* sum+=3;sum+=4;*/sum+=5;alert(sum);
比如說上面的代碼，他把中間兩行代碼注釋了。 沒注釋以前，sum是15,；注釋了以后sum是8. 這就證明了注釋了的代碼不會被執行。
所以在代碼中注釋也是扮演一種很重要的角色，他既可以解釋代碼，也可以注釋代碼。

總結

注釋很重要！注釋很重要！注釋很重要！ 在代碼中盡量多寫注釋，要讓別人看的懂，但是也不要寫一些沒用的注釋。 當你寫代碼的時候，你的注釋就是你與別人的交流語言，代表的是你的意思。

總結

以上是生活随笔為你收集整理的注释的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。