以 Windows 10 平台为例,介绍仓颉工具链的安装方式。

在 Windows 平台上,仓颉为开发者提供了 zip 格式的安装包,请前往仓颉官方发布渠道,选择和下载适配平台架构的 Windows 版安装包。
请将 zip 格式的安装包(例如 Cangjie-x.y.z-windows_x64.zip)解压到适当目录,在安装包中,仓颉为开发者提供了三种不同格式的安装脚本,分别是 envsetup.bat,envsetup.ps1 和 envsetup.sh,可以根据使用习惯及环境配置,选择一种执行:
若使用 Windows 命令提示符(CMD)环境,请执行:
path\to\cangjie\envsetup.bat
若使用 PowerShell 环境,请执行:
. path\to\cangjie\envsetup.ps1
若使用 MSYS shell、bash 等环境,请执行:
source path/to/cangjie/envsetup.sh
为了验证是否安装成功,请在以上命令环境中继续执行 cjc -v 命令,如果输出了仓颉编译器版本信息,表示已经成功安装了仓颉工具链。
注意:
基于 zip 安装包和执行脚本的安装方式,类似于 Linux 平台,即 envsetup 脚本所配置的环境变量,只在当前命令行环境中有效,如果打开新的命令行窗口,需要重新执行 envsetup 脚本配置环境。
若想使仓颉工具链的环境变量配置在命令提示符或终端启动时自动生效,可以对系统进行如下配置:
若使用 bash 环境,可以根据如下步骤操作:
在 $HOME/.bashrc 初始化配置文件的最后加入以下命令($HOME 为当前用户目录的路径):
# 假设仓颉安装包解压在 /home/user/cangjie 中
source /home/user/cangjie/envsetup.sh # 即 envsetup.sh 的绝对路径
配置完成后 bash 启动即可直接使用仓颉编译工具链。
若使用 Windows 命令提示符(CMD)、PowerShell 或其他环境,可以根据如下步骤操作:
在 Windows 搜索框中,搜索 “查看高级系统设置” 并打开对应窗口;
点击 “环境变量” 按钮;
执行如下操作,配置 CANGJIE_HOME 变量:
在 “用户变量”(为当前用户进行配置)或 “系统变量”(为系统所有用户进行配置)区域中,查看是否已有 CANGJIE_HOME 环境变量。若没有,则点击 “新建” 按钮,并在 “变量名” 字段中输入 CANGJIE_HOME ;若有,则说明该环境可能已经进行过仓颉配置,如果想要继续为当前的仓颉版本进行配置并覆盖原配置,请点击 “编辑” 按钮,进入 “编辑系统变量” 窗口。
在 “变量值” 字段中输入仓颉安装包的解压路径,若原先已经存在路径,则使用新的路径覆盖原有的路径,例如仓颉安装包解压在 D:\cangjie ,则输入 D:\cangjie 。
配置完成后 “编辑用户变量” 或 “编辑系统变量” 窗口应如下图所示。确认路径正确配置后点击 “确定” 按钮。
执行如下操作,配置 Path 变量:
在 “用户变量”(为当前用户进行配置)或 “系统变量”(为系统所有用户进行配置)区域中,找到并选择 Path 变量,点击 “编辑” 按钮,进入 “编辑环境变量” 窗口。
分别点击 “新建” 按钮,并分别输入 %CANGJIE_HOME%\bin 、 %CANGJIE_HOME%\tools\bin 、 %CANGJIE_HOME%\tools\lib 、 %CANGJIE_HOME%\runtime\lib\windows_x86_64_llvm (%CANGJIE_HOME% 为仓颉安装包的解压路径)。例如,仓库安装包解压在 D:\cangjie ,则新建的环境变量分别为: D:\cangjie\bin 、 D:\cangjie\tools\bin 、 D:\cangjie\tools\lib 、 D:\cangjie\runtime\lib\windows_x86_64_llvm 。
(仅适用于为当前用户设置)点击 “新建” 按钮,并输入当前用户目录路径,并在路径后面添加 .cjpm\bin 。例如用户路径在 C:\Users\bob ,则输入 C:\Users\bob\.cjpm\bin 。
配置完成后应能在 “编辑环境变量” 窗口中看到配置的路径,例如下图所示。确认路径正确配置后点击 “确定” 按钮。
点击 “确定” 按钮,退出 “环境变量” 窗口;
点击 “确定” 按钮,完成设置。
注意:
设置完成后可能需要重启命令行窗口或重启系统以让设置生效。
配置完成后 Windows 命令提示符(CMD)或 PowerShell 启动即可直接使用仓颉编译工具链。

在 Windows 平台,删除上述仓颉工具链的安装包目录,同时移除上述环境变量设置,即可完成卸载。
若需要更新仓颉工具链,需要先卸载当前版本,然后按上述指导重新安装最新版本的仓颉工具链。