跟老卫学仓颉编程语言开发：注释

注释是为了帮助阅读者快速读懂代码，所以要从读者的角度出发，按需注释。注释内容要简洁、明了、无二义性，信息全面且不冗余。注释跟代码一样重要。

在仓颉中，注释分为两类。

• 单行注释//
• 多行注释/*...*/

本节示例可以在“comment_demo”应用下找到。下载地址见文末链接。

单行注释

以下是单注释的示例：

// 获取函数的返回值
let a: Int64 = 1; // 第一个参数
let b: Int64 = 1; // 第二个参数

如上所示，单行注释用“//”标识，可以放在某一行代码的上方，也可以放在当前代码行的后方。

多行注释

多行注释也称为块注释。以下是块注释的示例：

/*
// 执行函数
println_hello();
*/

如上所示，块注释用“/* */”标识，只需要将注释内容使用块注释进行包裹即可。

参考引用

• 示例源码，见免费开源书《跟老卫学仓颉编程语言开发》
• 免费开源书《跟老卫学HarmonyOS开发》
• HarmonyOS NEXT+AI大模型打造智能助手APP（仓颉版）（视频）
• 仓颉编程从入门到实践（北京大学出版社）