第一个程序

跟着本教程，你会亲手创建一个 CK 文件，检查它有没有写错，再运行它并看到结果。全程只需要一个文本编辑器和 CalcKernel 编译器。

任何纯文本编辑器都能完成本教程。如果你习惯用 VS Code，可选装 CalcKernel 扩展；它会在写代码时提供高亮、实时错误提示和代码导航。

第一步：下载并放好编译器#

打开 CalcKernel 下载页，下载与你的电脑相符的版本。Apple 芯片 Mac 选 arm64，Intel Mac 选 x64；大多数 Windows 和 Linux 电脑选 x64。下载后解压缩。

解压出来的文件名带有系统和芯片名称，例如 ckc-darwin-arm64 或 ckc-win32-x64.exe。新建一个叫 ck-first-program 的文件夹，把这个编译器文件放进去，并在文件夹里再创建程序文件。为了让下面的命令一致，请把编译器文件重命名：

• macOS 或 Linux：改名为 ckc。
• Windows：改名为 ckc.exe。

在终端（macOS/Linux）或 PowerShell（Windows）中进入这个文件夹。比如文件夹在“下载”目录：

# macOS / Linux
cd ~/Downloads/ck-first-program

# Windows PowerShell
cd "$HOME\Downloads\ck-first-program"

确认编译器能启动：

# macOS / Linux
./ckc --version

# Windows PowerShell
.\ckc.exe --version

看到编译器打印版本信息，就可以继续了。命令前的 ./（macOS/Linux）或 .\（Windows PowerShell）表示“运行当前文件夹里的程序”。

第二步：创建 hello.ck#

用文本编辑器在 ck-first-program 文件夹里新建文件，文件名必须是 hello.ck。Windows 记事本和 macOS 文本编辑都可以：在 macOS 文本编辑中，先从“格式”菜单选择“制作纯文本”；保存时确认文件名没有变成 hello.ck.txt。Windows 记事本若打开“另存为”窗口，请把文件类型设为“所有文件”，再输入 hello.ck。

把下面的代码完整复制进去并保存：

fn main() -> i32 {
  print_i32(42);
  print_newline();
  return 0;
}

逐行看它做了什么：

• fn main() -> i32 {：定义程序从哪里开始运行。main 是入口的名字，i32 表示它最后会交回一个整数状态。
• print_i32(42);：在屏幕上显示整数 42。
• print_newline();：换到下一行。显示数字的命令本身不会自动换行。
• return 0;：告诉电脑程序正常结束。
• 最后一行的 }：表示程序内容到这里结束。

第三步：检查，再运行#

先检查程序。检查只会告诉你代码能否读懂，不会运行它。

# macOS / Linux
./ckc check hello.ck

# Windows PowerShell
.\ckc.exe check hello.ck

成功时会看到 OK: hello.ck。现在运行程序：

# macOS / Linux
./ckc run hello.ck

# Windows PowerShell
.\ckc.exe run hello.ck

屏幕上会出现：

42

恭喜，你已经写出并运行了第一个 CK 程序。

改一改，看看会发生什么#

把 print_i32(42); 改成 print_i32(6 * 7);，保存后再次运行同一个 run 命令。结果仍然是 42。这次传给显示命令的是一个乘法计算；CK 会先算出结果，再显示出来。

你也可以把 42 改成 hello 试试。检查器会指出哪一行有问题。把它改回数字，重新运行即可。

出错时先看这里#

• **提示找不到 ckc 或 hello.ck：**先确认终端当前位于 ck-first-program 文件夹。运行 pwd（PowerShell 也支持）查看当前文件夹，并确认文件名确实是 hello.ck。
• **文件其实叫 hello.ck.txt：**在文件管理器里显示文件扩展名，然后去掉最后的 .txt。
• **macOS/Linux 提示没有运行权限：**在教程文件夹中执行 chmod +x ./ckc，然后重新运行 ./ckc --version。
• **检查器指出行号和错误：**先看它指出的那一行，再核对大括号 { }、圆括号 ( ) 和每条语句结尾的分号 ;。
• **提示缺少 main：**用来运行的程序需要有上面的 fn main() -> i32。以后写给其他程序调用的计算时会使用不同的写法。

再往前一步#

现在可以学习语言基础，再到动手练习自己写几个小程序。ckc run 适合边学边运行；学会后，也可以用 ckc build 生成独立运行的程序。更多命令见输出方式和命令行入门。