支持兩種注釋字符:1、單行注釋符號“//”,只對所在行有效,可以位于代碼段的不同位置,語法“//需要注釋的內(nèi)容”,“//”之后的所有內(nèi)容都會看作是注釋的內(nèi)容。2、多行注釋符號“/**/”,出現(xiàn)在“/*”和“*/”之間的所有內(nèi)容都會看作是注釋的內(nèi)容,語法“/* 需要注釋的內(nèi)容 */”。
前端(vue)入門到精通課程:進入學習
API 文檔、設計、調(diào)試、自動化測試一體化協(xié)作工具:點擊使用
本教程操作環(huán)境:windows7系統(tǒng)、javascript1.8.5版、Dell G3電腦。
注釋是給開發(fā)人員看的,程序在執(zhí)行時會自動忽略注釋的內(nèi)容,所以我們通常使用注釋來為代碼添加一些解釋說明或描述,以提高代碼的可讀性。
JavaScript 中的注釋與 C/C++、Java、PHP 等語言中注釋的定義方式相同,支持單行注釋和多行注釋兩種風格。
-
單行注釋:使用"
//
"來進行單行注釋; -
多行注釋:使用"
/* */
"來進行多行注釋;
基本結構如下:
單行注釋
//我是被注釋掉的文字,這里也可以是js代碼
多行注釋:
/* 我是被注釋掉的文字 我假裝是被注釋掉的js代碼 */
單行注釋
單行注釋以 //
開頭。"//
"之后的所有內(nèi)容都會看作是注釋的內(nèi)容,對"//
"之前的內(nèi)容則不會產(chǎn)生影響
單行注釋可以位于代碼段的不同位置,分別描述不同區(qū)域代碼的功能。
//程序描述 function toStr(a){ //塊描述 //代碼段描述 return a.toString(); //語句描述 }
使用單行注釋時,在//
后面的同一行內(nèi)的任何字符或代碼都會被忽視,不再解析。
多行注釋
多行注釋以 /*
開始,以 */
結尾;出現(xiàn)在“/*
”和“*/
”之間的所有內(nèi)容都會看作是注釋的內(nèi)容。
多行注釋一般在js文件開頭,介紹作者,函數(shù)等信息。
/* * jQuery JavaScript Library v3.3.1 * https://jquery.com/ * Includes Sizzle.js * https://sizzlejs.com/ * Copyright JS Foundation and other contributors * Released under the MIT license * https://jquery.org/license * Date: 2019-08-21 T 17:24 Z */ document.getElementById("myH1").innerHTML="歡迎來到我的主頁"; document.getElementById("myP").innerHTML="這是我的第一個段落。";
<script> /* 這里是以下代碼的說明 我只是簡單的舉個例子 */ var a = 1; a = a + 5; console.log(a); </script>
在多行注釋中,包含在/*
和*/
符號之間的任何字符都視被為注釋文本而忽略掉。
補充說明:
在一些專用的代碼編輯器中,比如 "VScode","Notepad++"等,正常的執(zhí)行代碼與被注釋掉的代碼的顏色是不同的,很容易區(qū)分出來。
下面以'vscode'編輯器為例,如下圖
1、被注釋掉的代碼或說明的字體為綠色
2、正常的代碼為白色或其它顏色
3、由于編輯器或個人設置的原因,代碼編輯器中代碼顏色會有所不同
【