通过阅读代码能够了解程序在“做什么”,而通过阅读注释则能够了解“为什么要这样做”。在程序中,应该使用恰当的注释为代码添加描述性信息,以增加可读性和可维护性。在添加注释时,应该描述“为什么要这样做”,而非描述“做什么”。
TypeScript支持三种类型的注释:
- 单行注释
- 多行注释
- 区域注释
单行注释与多行注释
单行注释使用双斜线“//”来表示,并且不允许换行。示例如下:
// single line comment
const x = 0;
多行注释以“/*”
符号作为开始并以“*/”
符号作为结束。正如其名,多行注释允许换行。示例如下:
/** multi-line comment*/
const x = 0;
/**
* multi-line comment
* multi-line comment
*/
const y = 0;
在Visual Studio Code中,单行注释和多行注释有一处体验上的差别。当将鼠标悬停在标识符上时,只有多行注释中的内容会显示在提示框中,单行注释中的内容不会显示在提示框中,如图所示:
区域注释
折叠代码是编辑器的常用功能,Visual Studio Code能够识别出代码中可以折叠的代码块,如函数和if语句等,并允许将其折叠或展开,如图所示。
区域注释不是一种新的注释语法,它借助单行注释的语法实现了定义代码折叠区域的功能。区域注释的语法如下所示:
//#region 区域描述
let x = 0;
//#endregion
其中,“//#region”
定义了代码折叠区域的起始位置,“//#endregion”
定义了代码折叠区域的结束位置。区域描述用于描述该折叠区域,当代码被折叠起来时,该描述信息会显示出来,如图所示。
酷客网相关文章:
评论前必须登录!
注册