本篇详细介绍在Mac系统上创建首个Cangjie项目并编写、运行第一个Cangjie程序的全过程。内容涵盖项目创建、代码编写、程序运行与调试，以及代码修改后的重新运行。通过本篇，掌握Cangjie项目的基本操作，进一步巩固开发环境的配置，迈出Cangjie编程的第一步。

关键词

• Cangjie程序编写
• 首个Cangjie项目创建
• Cangjie代码调试
• VSCode使用指南
• Mac Cangjie开发
• Cangjie项目运行

---

一、创建首个Cangjie项目

1.1 创建项目

1. 打开 VSCode，使用快捷键 Shift + Command + P 打开命令面板。

2. 输入 cangjie，选择 Create Cangjie Project 选项。

   

3. 选择 Create CJNative Cangjie project 选项。

   

4. 在弹出的菜单中，选择 Create Executable Output Cangjie project 选项。

   

5. 选择项目路径，例如 /Users/用户名/Projects/CangjieProject，输入项目名称，然后按 Enter。

   

6. 确认创建后，自动生成 main.cj 文件。

1.2 打开项目

1. 使用 VSCode 打开项目文件夹。

2. 在 Explorer 侧边栏中，导航至 src/main.cj 文件，查看默认代码：

   main(): Int64 {
       println("hello world")
       return 0
   }
   

1.3 运行项目

1.3.1 配置环境

1. 在 VSCode 中打开终端。

2. 输入以下命令以配置环境：

   source /Users/用户名/cangjie/envsetup.sh
   

   注意：将 用户名 替换为Mac系统的实际用户名。

1.3.2 执行程序

1. 在终端中输入以下命令运行项目：

   cjpm run
   

2. 检查终端输出，确保显示：

   hello world
   

1.3.3 修改并重新运行程序

1. 打开 src/main.cj 文件，修改 println 语句，例如：

   main(): Int64 {
       println("hello world")
       println("你好，仓颉")
       return 0
   }
   

2. 保存文件后，返回终端，确保环境已配置（如未配置，可重新执行 source 命令）。

3. 再次运行程序：

   cjpm run
   

4. 检查终端输出，确保显示：

   hello world
   你好，仓颉
   

---

二、代码调试

调试是编程过程中不可或缺的一部分，通过调试可以有效地查找和修复代码中的错误。以下是在 VSCode 中进行Cangjie程序调试的步骤：

2.1 设置断点

1. 打开 src/main.cj 文件。
2. 在需要检查的代码行左侧单击，设置断点。例如，在 println(“hello world”) 行设置断点。

2.2 启动调试

1. 在 VSCode 中，点击左侧活动栏的 Run and Debug 图标，或使用快捷键 Control + Shift + D。

2. 点击 Start Debugging 按钮（绿色箭头），或按 F5。

3. 程序将运行并在断点处暂停，允许检查变量和程序状态。

2.3 检查变量和调用堆栈

1. 当程序在断点处暂停时，查看 Variables 面板，检查变量的当前值。
2. 使用 Call Stack 面板查看函数调用顺序。
3. 可以逐步执行代码，使用 Step Over （F10）、Step Into （F11）和 Step Out （Shift + F11）功能。

2.4 结束调试

1. 调试完成后，点击 Stop 按钮或使用快捷键 Shift + F5 结束调试会话。

---

小结

本篇完成了创建首个Cangjie项目的全过程，验证了开发环境的正确配置，并成功编写、运行及修改了第一个Cangjie程序。通过这些步骤，奠定了Cangjie项目开发的坚实基础，并介绍了如何在 VSCode 中进行代码调试，提升了编程效率和代码质量。

---

下篇预告

下一篇将探讨Cangjie的基本语法与结构，深入了解语言特性，提升编程能力，敬请期待！

---

上一篇：「Mac玩转仓颉内测版1」入门篇1 - Cangjie环境的搭建

下一篇：「Mac玩转仓颉内测版3」入门篇3 - Cangjie的基本语法与结构

---

作者：SoraLuna
链接：https://www.nutpi.net/thread?topicId=74
來源：坚果派
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。

---