1.3　我的第一个仓颉程序

为了测试开发环境，现在，让我们开始编写第一个仓颉程序。

首先，在仓颉工程文件夹的目录src下新建一个文件：hello_cangjie.cj。该文件的名称为hello_cangjie，扩展名为cj，表示这是一个仓颉源文件。接着，在hello_cangjie.cj中，输入以下代码，如代码清单1-1所示。

代码清单1-1　hello_cangjie.cj

01   main() {
02       println("你好，仓颉！")  // 输出字符串"你好，仓颉！"并换行
03   }

注意，代码中所有的有效字符都必须是半角的字符，例如“(”。在集成开发环境中编译并执行程序，输出结果为：

你好，仓颉！

这是一个最简单的仓颉程序，只包含一个main，main中只有一行代码。下面我们来解释一下这个程序的各个部分。

1．main

main是程序执行的入口。在编译并执行程序之后，系统自动从main开始执行花括号中的代码。如果在将仓颉源程序编译为可执行程序时缺少了main，就会引发编译错误。

一个不包含任何代码的main如下所示：

main() {}

在刚开始学习仓颉编程时，我们添加的大部分代码都是放在main中的。在向main中添加代码时，所有的代码要添加到main的一对花括号之间，并且最好能够遵循以下编程规范。

● 在左花括号之后换行。

● 换行之后输入代码。花括号中的所有代码作为一个整体，要有一个级别的缩进。一个级别的缩进一般是4个空格，对于UI等多层嵌套使用较多的情况，可以统一使用2个空格。

● 右花括号独占一行。

提示

作为刚刚接触编程的初学者，乍一看到这些编程规范，可能一时间不能很快适应，这是正常现象。只要在学习过程中仔细观察并学习示例程序，就可以很快掌握这些编程规范。

2．关键字

仓颉编程语言定义了70多个 关键字 ，每个关键字在程序中都有 特定的用途 。例如，Bool被用于表示布尔类型，if被用于条件判断等。代码清单1-1中的main就是一个关键字。

3．字符串类型的字面量

程序中“ 具有明确数据类型的、固定的值 ”被称为 字面量 ，例如，“你好，仓颉！”就是一个字符串类型的字面量。在程序中，文本内容可以使用字符串类型来表示。将文本内容使用 一对半角的双引号 括起来，就得到了一个字符串类型的字面量。以下是一些字符串类型的字面量的示例：

"业精于勤"
"Have a good day!"
"^_^"

4．println函数

在main中，只有一行代码：

println("你好，仓颉！")

在这行代码中，使用println函数将字符串"你好，仓颉！"输出到终端并且换行。为了提高编程效率，仓颉为我们定义了很多 函数 。在需要时，我们可以直接 调用 这些函数以实现特定的目标。如果需要向终端输出一些内容，可以将需要输出的内容放在println函数的一对圆括号内。例如，使用以下代码输出字面量18：

println(18)

5．注释

在println函数之后，有一行以“//”开头的文字，这是一个注释。 注释 是对代码的说明和对程序的解释。注释中的文字不是有效的代码。在编译并执行程序时，所有注释都会被系统忽略。

仓颉中的注释有两种： 单行注释 （//）和 多行注释 （/*…*/）。

单行注释使用“//”表示，“//”之后的内容即是注释的内容。单行注释不能跨越多行。在代码中，建议将单行注释放在相应代码的右侧或者上方。当单行注释放在代码右侧时，注释与代码之间至少需要留有一个空格。在代码清单1-1中，单行注释就被放在了代码的右侧。

当单行注释过长时，建议将注释放在代码上方，并且与代码保持同样级别的缩进。如果将代码清单1-1中的注释改为放在代码上方，那么该段代码可表示为：

main() {
    // 输出字符串"你好，仓颉！"并换行
    println("你好，仓颉！")
}

多行注释以“/*”开头，以“*/”结尾，“/*”和“*/”中间即是注释的内容，注释的内容可以跨越多行。对于多行注释，建议放在对应代码的上方，注释与代码保持一样的缩进级别。如果是文件头注释，那么建议放在文件开头，不使用缩进。

下面是一个文件头注释的示例，在仓颉源文件的开头添加了多行注释，其中列出了作者等信息：

/*
 * 作者：刘玥 张荣超
 * 抖音/微信视频号/微信公众号：九丘教育
 */
　
main() {
    println("你好，仓颉！")  // 输出字符串"你好，仓颉！"并换行
}

尽管注释不是有效的代码，但是注释可以很好地对程序进行解释和说明，是程序十分重要的组成部分。清晰、简洁的注释可以大大提高程序的可读性和可维护性。

提示

良好的编程习惯将使你受益终生，在编程时应该为需要说明的代码编写简明的注释。

练习

1．尝试将以上示例程序中的字符串修改为其他内容，编译并执行程序。

2．尝试在程序中添加各种注释。

本章需要达成的学习目标（目标完成后可在前面的方框中打勾）

❏ 安装仓颉集成开发环境，并测试能否正常运行。

❏ 通过一个简单的仓颉程序开始编程实践，了解仓颉程序运行的过程。

❏ 了解main的概念。

❏ 了解字符串、println函数的用法。

❏ 掌握两种注释的编写方式。 su3OON2nXgVzsJwnD/ECm8rdBGEOsjpGsLTmeXKJwCI453pX14pcb/qzeL50AVlD