仓颉编程语言-02-VSCode插件使用

仓颉编程语言是一款面向全场景智能的新一代编程语言，主打原生智能化、天生全场景、高性能、强安全。主要应用于鸿蒙原生应用及服务应用等场景中，为开发者提供良好的编程体验。

前面的内容中，已经完成了仓颉编程语言的简介，在线与本地使用，现在基于VSCode完成仓颉编程语言的开发与使用。

仓颉编程语言VSCode插件下载

进入下载地址：https://cangjie-lang.cn/download/0.53.13

选择VScode Plugin下载。

下载到本地后，解压，解压后的目录如下：

其中.vsix 文件 就是VScode的插件端

仓颉编程语言的VScode插件安装

VSCode 安装本地插件
按照下图所示操作，选择拓展插件图标–更多选项–Install from VSIX，

打开文件资源管理器对话框，找到要安装的插件.vsix，点击确定即可安装。

即可完成安装。
已经安装的插件可以在 INSTALLED 目录下查看

在前面的部分已经完成仓颉SDK的本地安装，如下

VScode配置仓颉SDK 路径

插件支持 CJNative 后端和 CJVM 后端两种 SDK 的使用，目前 CJVM 后端只支持 Linux 系统。

安装完 Cangjie 插件后，即可配置 SDK 的路径。点击左下角齿轮图标，选择设置选项，在搜索栏输入 cangjie：

， 然后选择Extensions下的cangjie下的 Cangjie Language Support 选项，如下。

CJNative 后端的 SDK 路径配置

1.找到 Cangjie Sdk: Option 选项，选择后端类型为 CJNative（默认是此选项）
2.找到 Cangjie Sdk Path: CJNative Backend 选项，输入 CJNative 后端 SDK 文件所在绝对路径

D:\software\Cangjie-0.53.13-windows_x64\cangjie

3.重启 VScode 生效

基于VScode开发仓颉项目

仓颉项目的目录结构

使用 VSCode 打开一个文件夹，将其中的仓颉源码分为两部分：一部分是顶层 src 目录下的仓颉源码，另一部分是非 src 目录下的仓颉源码。仓颉语言服务支持的目录结构如下：

限制一

语言服务插件仅为用户打开的文件夹下仓颉源码提供语言服务。以用户打开的文件夹为仓颉项目的根目录 PROJECTROOT（如果用户没有明确指定模块名称，默认将 PROJECTROOT 目录名称作为模块名，以方便用户导入 src 下的包），PROJECTROOT/src 为 src 下仓颉源码（支持语言服务）；除了 src 下的仓颉源码，PROJECTROOT 下的所有源码称为非 src 下仓颉源码（支持语言服务）；PROJECTROOT 之外的仓颉源码称为外部源码（暂不支持语言服务）。

限制二

非 src 下每个文件夹都作为一个包，包名的声明和包的编译方式与 src 下顶层包（即 default 包）处理方式保持一致。非 src 下的仓颉源码可以导入标准库的包以及 src 下用户自定义的包，非 src 下的包无法被其他包导入。

限制三

Linux 、 Windows 、 macOS 平台下均需要先设置 Cangjie SDK 路径。

通过 VSCode 命令面板创建仓颉工程

在 VSCode 中先打开一个文件夹，如pro01文件夹，然后按 F1 或者 Ctrl + Shift + P（mac 上快捷键为 Command + Shift + P） 或view下的command palette打开命令面板，

然后按照以下步骤创建仓颉工程：

第一步：选择创建 Cangjie 工程命令

第二步：选择 Cangjie 后端

第二步：选择 Cangjie 工程模板

第三步：选择工程路径
这里选择的是cjcpro目录，会在cjcpro目录下创建一个仓颉工程，该工程与pro01目录并列

选择工程位置后，输入工程名称为cjpro01

单击回车键，会弹出一个新的窗口，该窗口就是VScode创建的仓颉工程cjpro01.

打开src下的main.cj会查看到仓颉的demo

编译构建

注：VSCode 中可视化方式提供的仓颉功能编译构建能力依赖 cjpm 工具，该工具要求打开的仓颉工程的模块内必须包含规范的 cjpm.toml 文件。若没有该文件仍想执行工程的编译构建，可在终端使用 cjc 命令。

在 VSCode 中提供四种方式来实现 Cangjie 工程的编译构建方式。
具体可以参考官网，连接如下：
https://cangjie-lang.cn/docs?url=%2F0.53.13%2Ftools%2Fsource_zh_cn%2FIDE%2Fuser_manual.html

我们仅演示2种。

在命令面板执行命令

打开命令面板，通过分类词"Cangjie"来快速找到如下编译相关命令：
Build With Verbose 编译并展示编译日志
输出如下

点击运行按钮运行工程

用户可以点击 cj 文件编辑区的运行按钮来运行整个仓颉工程

若整个工程中配置的output-type为executable时会在终端面板打印运行结果，否则只会显示编译的结果。

点击运行按钮执行的编译过程是结合当前的 cjpm.toml 和 cjpm_build_args.json 的配置来进行的

总结

到此完成了仓颉语言的VScode插件使用与开发，我会持续更新。
仓颉编程语言作为一个新出现的语言，对其抱有很大的希望，但一个语言的发展也需要很多年的完善，一路同行，共同进步。

仓颉官方链接