快速开始

3.1第一个程序

新建一个文件 hello.cql，输入以下内容：

# hello.cql
打印("你好，世界！")
打印("这是 CQL（Chinese Query Language）")

# 中文变量名与中文内置函数
姓名 = "喵酱"
打印("欢迎使用 CQL，", 姓名)

可以看到，CQL 的源码几乎与自然语言一样易读：打印 是内置输出函数，变量名可以直接使用中文。

3.2运行程序

在终端中执行：

$ cql run hello.cql

控制台会输出：

你好，世界！
这是 CQL（Chinese Query Language）
欢迎使用 CQL， 喵酱

此外，cql build hello.cql 会生成 hello.py；cql repl 可以进入交互式解释器，逐行执行 CQL 代码。

3.3在 Python 中以库方式使用

CQL 本质上是一个源代码转译器，因此也可以在 Python 中直接调用：

import cql
代码 = cql.compile('打印("你好")')
print(代码)        # print("你好")
exec(代码)

如果需要编译整个文件，可以使用 cql.compile_file("examples/fibonacci.cql")，它会返回对应的 Python 代码字符串。

3.4语法要点速查

下表列出了 CQL 与 Python 的关键字对照，方便快速上手：

3.5下一步

到这里你已经掌握了 CQL 的基本用法，接下来可以学习 CQL 的基本语法，深入了解注释、缩进、中文标识符等核心概念。