注释是为了帮助阅读者快速读懂代码,所以要从读者的角度出发,按需注释。注释内容要简洁、明了、无二义性,信息全面且不冗余。注释跟代码一样重要。
在仓颉中,注释分为两类。
- 单行注释
// - 多行注释
/*...*/
本节示例可以在“comment_demo”应用下找到。下载地址见文末链接。
单行注释
以下是单注释的示例:
// 获取函数的返回值
let a: Int64 = 1; // 第一个参数
let b: Int64 = 1; // 第二个参数
如上所示,单行注释用“//”标识,可以放在某一行代码的上方,也可以放在当前代码行的后方。
多行注释
多行注释也称为块注释。以下是块注释的示例:
/*
// 执行函数
println_hello();
*/
如上所示,块注释用“/* */”标识,只需要将注释内容使用块注释进行包裹即可。
参考引用
- 示例源码,见免费开源书《跟老卫学仓颉编程语言开发》
- 免费开源书《跟老卫学HarmonyOS开发》
- HarmonyOS NEXT+AI大模型打造智能助手APP(仓颉版)(视频)
- 仓颉编程从入门到实践(北京大学出版社)

随时随地看视频