安装仓颉工具链

在开发仓颉程序时，必用的工具之一是仓颉编译器，它可以将仓颉源代码编译为可运行的二进制文件，但现代编程语言的配套工具并不止于此，实际上，我们为开发者提供了编译器、调试器、包管理器、静态检查工具、格式化工具和覆盖率统计工具等一整套仓颉开发工具链，同时提供了友好的安装和使用方式，基本能做到“开箱即用”。

目前仓颉工具链已适配部分版本的 Linux、macOS 和 Windows 平台，但是仅针对部分 Linux 发行版做了完整功能测试，详情可参阅附录Linux 版本工具链的支持与安装章节，在暂未进行过完整功能测试的平台上，仓颉工具链的功能完整性不受到保证。此外，当前 Windows 平台上的仓颉编译器基于 MinGW 实现，相较于 Linux 版本的仓颉编译器，功能会有部分欠缺。

Linux / macOS

环境准备

Linux

Linux 版仓颉工具链的系统环境要求如下：

除此之外，对于不同的 Linux 发行版，还需要安装相应的依赖软件包：

Ubuntu 18.04

$ apt-get install binutils libc-dev libc++-dev libgcc-7-dev

EulerOS R11

$ yum install binutils glibc-devel gcc

此外，仓颉工具链还依赖 OpenSSL 3 组件，由于该组件可能无法从以上发行版的默认软件源直接安装，因此你需要自行手动安装，安装方式请参考附录Linux 版本工具链的支持与安装章节。

其他 Linux 发行版

您可以在附录Linux 版本工具链的支持与安装章节找到更多 Linux 发行版的依赖安装命令。

macOS

macOS 版仓颉工具链支持在 macOS 12.0 及以上版本运行。

使用 macOS 版本前需要安装相应的依赖软件包，您可以通过执行以下命令安装：

$ brew install libffi

安装指导

首先请前往仓颉官方发布渠道，下载适配您平台架构的安装包：

• Cangjie-x.y.z-linux_x64.tar.gz：适用于 x86_64 架构 Linux 系统的仓颉工具链
• Cangjie-x.y.z-linux_aarch64.tar.gz：适用于 aarch64 架构 Linux 系统的仓颉工具链
• Cangjie-x.y.z-darwin_x64.tar.gz：适用于 x86_64 架构 macOS 系统的仓颉工具链
• Cangjie-x.y.z-darwin_aarch64.tar.gz：适用于 aarch64/arm64 架构 macOS 系统的仓颉工具链

假设这里选择了 Cangjie-x.y.z-linux_x64.tar.gz，下载到本地后，请执行如下命令解压：

tar xvf Cangjie-x.y.z-linux_x64.tar.gz

解压完成，您会在当前工作路径下看到一个名为 cangjie 的目录，其中存放了仓颉工具链的全部内容，请执行如下命令完成仓颉工具链的安装配置：

source cangjie/envsetup.sh

为了验证是否安装成功，可以执行如下命令：

cjc -v

其中 cjc 是仓颉编译器的可执行文件名，如果您在命令行中看到了仓颉编译器版本信息，那么恭喜您，已经成功安装了仓颉工具链。值得说明的是，envsetup.sh 脚本只是在当前 shell 环境中配置了工具链相关的环境变量，所以仓颉工具链仅在当前 shell 环境中可用，在新的 shell 环境中，您需要重新执行 envsetup.sh 脚本配置环境。

卸载与更新

在 Linux 平台，删除上述仓颉工具链的安装包目录，同时移除上述环境变量（最简单的，您可以新开一个 shell 环境），即可完成卸载。

$ rm -rf <path>/<to>/cangjie

若需要更新仓颉工具链，您需要先卸载当前版本，然后按上述指导重新安装最新版本的仓颉工具链。

Windows

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

安装指导

在 Windows 平台上，我们为开发者提供了 exe 和 zip 两种格式的安装包，请前往仓颉官方发布渠道，选择和下载适配您平台架构的 Windows 版安装包。

如果您选择了 exe 格式的安装包（例如 Cangjie-x.y.z-windows_x64.exe），请直接执行此文件，跟随安装向导点击操作，即可完成安装。

如果您选择了 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 脚本配置环境。

卸载与更新

运行仓颉安装目录下的 unins000.exe 可执行文件，跟随卸载向导点击操作，即可完成卸载。

若需要更新仓颉工具链，您需要先卸载当前版本，然后按上述指导重新安装最新版本的仓颉工具链。