仓颉学习笔记2 - 在Visual Studio Code中安装仓颉插件，创建并运行第一个仓颉项目

海洋饼干叔叔

发布于：2024年10月2日

仓颉

作为新生的，不用背负任何历史包袱的全新语言，仓颉充分吸收了过去数十年来众多编程语言之长，原生智能化、天生全场景、高性能、强安全。作为华为鸿蒙系统的平台语言，仓颉拥有良好的发展潜力和前景，极有可能成为第一款形成世界级影响的国产编程语言。青少年现在学习仓颉，就是在投资未来！

版权声明

作者：重庆大学陈波

本文可以在互联网上自由转载，但必须注明出处(作者：海洋饼干叔叔)并包含指向本页面的链接。本文不可以以纸质出版为目的进行改编、摘抄。

1.5 在Visual Studio Code里安装并配置仓颉插件

多数情况下，程序员习惯在诸如Visual Studio Code这样的IDE（Integrated Development Environment）环境中进行程序编写和调试，因为在终端（如Windows PowerShell）里通过命令编译、运行程序十分繁琐。为了在Visual Studio Code中编辑、编译和运行仓颉语言程序，我们需要安装仓颉插件（Plugin）。Visual Studio Code的下载、安装过程，请扫描阅读页侧二维码，此处不再赘述。

首先，我们需要从开源开发者平台GitCode的仓颉社区下载仓颉插件，对应图1-3中的倒数第2项。遵照本书1.3节中所述的方法，我们下载得到仓颉插件压缩包（文件扩展名tar.gz表示一种压缩文件格式），如图1-17所示。

图1-17 仓颉插件压缩包

在Windows文件管理器中选中该文件，然后点击位于图1-17黑框处的“全部解压缩”按钮，然后在弹出的“提取存档”对话框（图1-18）中点击“提取”按钮。

图1-18 压缩包提取存档对话框

稍作等待后，压缩包文件的所在文件夹内将多出来一个同名文件夹，如图1-19所示。这个新的文件夹（Cangjie-vscode-0.55.3）即压缩包解压缩之后的结果文件夹，进入该文件夹，可见一个扩展名为vsix的仓颉插件安装文件，如图1-20所示。

图1-19 压缩包解压缩结果

图1-20 扩展名为vsix的仓颉插件安装文件

图1-21 在Visual Studio Code中安装仓颉插件

运行Visual Studio Code，点击扩展按钮进入扩展（Extensions）页面，然后点击图1-21中黑框处的”…”按钮，并在弹出菜单中选择“Install from VSIX…”。

图1-22 定位并选中仓颉插件安装文件

接下来在弹出对话框中定位并找到之前解压缩出来的仓颉插件安装文件，然后点击“Install”按钮，如图1-22所示。

稍后，我们便可以在Visual Studio Code的Extensions页面中看到安装好的仓颉（Cangjie）语言插件，如图1-23所示。点击该插件右侧的齿轮按钮（图中黑框处），然后在弹出菜单中选择“Extension Settings”（扩展设置）。

图1-23 进入仓颉插件的设置页面

图1-24 在仓颉插件的设置页面设置仓颉SDK的安装位置

在仓颉插件的设置页面，我们需要检查仓颉SDK(编译器)的安装位置是否正确，见图1-24中黑框处。在本书1.3节安装仓颉SDK时，我们选择的安装目录是C:\Cangjie，因此将该路径修改为“C:\Cangjie”。

至此，Visual Studio Code中的仓颉插件就安装并配置完成了。

1.6 第一个仓颉项目：世界，你好

具备实用性的软件通常由多个程序文件以及数据文件组成，而不是如1.4节中示例那样只包含一个仓颉程序文件。仓颉以项目（Project）形式来管理构成同一个应用程序的多个程序及数据文件。

为便于演示，我们先手工删除了在1.4节中创建的C:\PRACTICE目录下的全部文件及子文件夹。然后，运行Visual Studio Code，并按下快捷键Ctrl+Shift+P。具体操作时，先用左手按住Ctrl和Shift键不放，然后用右手按下P键。

然后在弹出对话框中输入“create cangjie”进行搜索，找到如图1-25所示的“Create Cangjie Project”菜单项并点击。

图1-25 创建仓颉项目第1步

接下来选择“Create CJNative Cangjie project”（创建仓颉原生项目），如图1-26所示。

图1-26 创建仓颉项目第2步

接下来选择“Create Executable Output Cangjie project”（创建生成可执行文件输出的仓颉项目），如图1-27所示。

图1-27 创建仓颉项目第3步

接下来，定位并找到C:\PRACTICE文件夹，并点击“Select projection location”（选择项目位置），如图1-28所示。

图1-28 创建仓颉项目第4步

然后在图1-29中的对话框中输入项目名称，本例我们输入“HelloWorld”，然后按下Enter键。

图1-29 创建仓颉项目第5步

如图1-30所示，一个新的Visual Studio Code窗口被创建出来。可见，HELLOWORLD项目已经被打开，请留意图中黑框处。此时，图1-30中背后位置的Visual Studio Code窗口已经没用了，可以将其关闭。

图1-30 创建仓颉项目第6步

接下来，将Visual Studio Code中“Explorer”页面里“HELLOWORLD”项目的src子目录展开，可见其中有一个名为main.cj的仓颉程序文件，点击该文件后，Visual Studio Code将打开该程序文件。细心的读者可能会发现，图1-31中main.cj的程序代码是彩色的，而本书1.4节中1.cj的程序代码是黑色的。除此之后，窗口的右上角还多出来一个三角形按钮（图1-31黑框处），点击该按钮可以编译并运行当前的仓颉项目。点击该按钮并稍作等待后，我们发现下侧“TERMINAL”（终端）页面中，出现了“hello world”字样，这正好对应程序main.cj第4行的执行输出。

图1-31 创建仓颉项目第7步

为了弄清项目的文件结构，我们在Windows资源管理器中打开了C:\PRACTICE\HelloWorld文件夹，如图1-32所示。其中，cjpm.toml为项目管理文件，其内容描述了该项目的内部组成及编译构建参数；src目录用于存储项目的全部程序文件；target目录用于存储程序文件的编译结果，包括可执行文件及一些过程文件。