支持兩種注釋字符:1、單行注釋符號(hào)“//”,只對(duì)所在行有效,可以位于代碼段的不同位置,語法“//需要注釋的內(nèi)容”,“//”之后的所有內(nèi)容都會(huì)看作是注釋的內(nèi)容。2、多行注釋符號(hào)“/**/”,出現(xiàn)在“/*”和“*/”之間的所有內(nèi)容都會(huì)看作是注釋的內(nèi)容,語法“/* 需要注釋的內(nèi)容 */”。
前端(vue)入門到精通課程:進(jìn)入學(xué)習(xí)
API 文檔、設(shè)計(jì)、調(diào)試、自動(dòng)化測(cè)試一體化協(xié)作工具:點(diǎn)擊使用
本教程操作環(huán)境:windows7系統(tǒng)、javascript1.8.5版、Dell G3電腦。
注釋是給開發(fā)人員看的,程序在執(zhí)行時(shí)會(huì)自動(dòng)忽略注釋的內(nèi)容,所以我們通常使用注釋來為代碼添加一些解釋說明或描述,以提高代碼的可讀性。
JavaScript 中的注釋與 C/C++、Java、PHP 等語言中注釋的定義方式相同,支持單行注釋和多行注釋兩種風(fēng)格。
-
單行注釋:使用"
//
"來進(jìn)行單行注釋; -
多行注釋:使用"
/* */
"來進(jìn)行多行注釋;
基本結(jié)構(gòu)如下:
單行注釋
//我是被注釋掉的文字,這里也可以是js代碼
多行注釋:
/* 我是被注釋掉的文字 我假裝是被注釋掉的js代碼 */
單行注釋
單行注釋以 //
開頭。"//
"之后的所有內(nèi)容都會(huì)看作是注釋的內(nèi)容,對(duì)"//
"之前的內(nèi)容則不會(huì)產(chǎn)生影響
單行注釋可以位于代碼段的不同位置,分別描述不同區(qū)域代碼的功能。
//程序描述 function toStr(a){ //塊描述 //代碼段描述 return a.toString(); //語句描述 }
使用單行注釋時(shí),在//
后面的同一行內(nèi)的任何字符或代碼都會(huì)被忽視,不再解析。
多行注釋
多行注釋以 /*
開始,以 */
結(jié)尾;出現(xiàn)在“/*
”和“*/
”之間的所有內(nèi)容都會(huì)看作是注釋的內(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="這是我的第一個(gè)段落。";
<script> /* 這里是以下代碼的說明 我只是簡(jiǎn)單的舉個(gè)例子 */ var a = 1; a = a + 5; console.log(a); </script>
在多行注釋中,包含在/*
和*/
符號(hào)之間的任何字符都視被為注釋文本而忽略掉。
補(bǔ)充說明:
在一些專用的代碼編輯器中,比如 "VScode","Notepad++"等,正常的執(zhí)行代碼與被注釋掉的代碼的顏色是不同的,很容易區(qū)分出來。
下面以'vscode'編輯器為例,如下圖
1、被注釋掉的代碼或說明的字體為綠色
2、正常的代碼為白色或其它顏色
3、由于編輯器或個(gè)人設(shè)置的原因,代碼編輯器中代碼顏色會(huì)有所不同
【