Installing the Cangjie Toolchain
Inspect one language lane at a time so line-level text and code deltas stay readable.
Diff Lane
English
0 modified sections0 code block delta0 anchor delta
Diff Lane
中文
2 modified sections0 code block delta0 anchor delta
modifiedLinuxtext+1 line, -1 line
v1.0.5
Section Text
1
Linux 版仓颉工具链的系统环境要求如下：2
3
| 架构 | 环境要求 |4
| ------- | ------------------------------------------------------------ |5
| x86_64 | glibc 2.22，Linux Kernel 4.12 或更高版本，系统安装 libstdc++ 6.0.24 或更高版本 |6
| aarch64 | glibc 2.27，Linux Kernel 4.15 或更高版本，系统安装 libstdc++ 6.0.24 或更高版本 |7
8
除此之外，对于 Ubuntu 18.04，还需要安装相应的依赖软件包：9
10
11
更多 Linux 发行版的依赖安装命令可以参见附录[Linux 版本工具链的支持与安装](../Appendix/linux_toolchain_install.md)章节。12
13
此外，仓颉工具链还依赖 OpenSSL 3 组件，由于该组件可能无法从以上发行版的默认软件源直接安装，因此需要自行手动安装，安装方式请参考附录[Linux 版本工具链的支持与安装](../Appendix/linux_toolchain_install.md)章节。Code 1 · bash
1
$ apt-get install binutils libc-dev libc++-dev libgcc-7-devv1.1.0
Section Text
1
Linux 版仓颉工具链的系统环境要求如下：2
3
| 架构 | 环境要求 |4
| ------- | ------------------------------------------------------------ |5
| x86_64 | glibc 2.27，Linux Kernel 4.15 或更高版本，系统安装 libstdc++ 6.0.24 或更高版本 |6
| aarch64 | glibc 2.27，Linux Kernel 4.15 或更高版本，系统安装 libstdc++ 6.0.24 或更高版本 |7
8
除此之外，对于 Ubuntu 18.04，还需要安装相应的依赖软件包：9
10
11
更多 Linux 发行版的依赖安装命令可以参见附录[Linux 版本工具链的支持与安装](../Appendix/linux_toolchain_install.md)章节。12
13
此外，仓颉工具链还依赖 OpenSSL 3 组件，由于该组件可能无法从以上发行版的默认软件源直接安装，因此需要自行手动安装，安装方式请参考附录[Linux 版本工具链的支持与安装](../Appendix/linux_toolchain_install.md)章节。Code 1 · bash
1
$ apt-get install binutils libc-dev libc++-dev libgcc-7-devmodified安装指导text+2 lines, -2 lines
v1.0.5
Section Text
1
在 Windows 平台上，仓颉为开发者提供了 `exe` 和 `zip` 两种格式的安装包，请前往仓颉官方发布渠道，选择和下载适配平台架构的 Windows 版安装包。2
3
- 如果选择 `exe` 格式的安装包（例如 `cangjie-sdk-windows-x64-x.y.z.exe`），请直接执行此文件，跟随安装向导点击操作，即可完成安装。4
5
- 如果选择 `zip` 格式的安装包（例如 `cangjie-sdk-windows-x64-x.y.z.zip`），请将它解压到适当目录，在安装包中，仓颉为开发者提供了三种不同格式的安装脚本，分别是 `envsetup.bat`，`envsetup.ps1` 和 `envsetup.sh`，可以根据使用习惯及环境配置，选择一种执行：6
7
- 若使用 Windows 命令提示符（CMD）环境，请执行：8
9
```bash10
path\to\cangjie\envsetup.bat11
```12
13
- 若使用 PowerShell 环境，请执行：14
15
```bash16
. path\to\cangjie\envsetup.ps117
```18
19
- 若使用 MSYS shell、bash 等环境，请执行：20
21
```bash22
source path/to/cangjie/envsetup.sh23
```24
25
为了验证是否安装成功，请在以上命令环境中继续执行 `cjc -v` 命令，如果输出了仓颉编译器版本信息，表示已经成功安装了仓颉工具链。26
27
**值得注意的是**，基于 zip 安装包和执行脚本的安装方式，类似于 Linux 平台，即 envsetup 脚本所配置的环境变量，只在当前命令行环境中有效，如果打开新的命令行窗口，需要重新执行 envsetup 脚本配置环境。此时，若想使仓颉工具链的环境变量配置在命令提示符或终端启动时自动生效，可以对系统进行如下配置：28
29
- 若使用 bash 环境，可以根据如下步骤操作：30
31
在 `$HOME/.bashrc` 初始化配置文件的最后加入以下命令（`$HOME` 为当前用户目录的路径）：32
33
```shell34
# 假设仓颉安装包解压在 /home/user/cangjie 中35
source /home/user/cangjie/envsetup.sh # 即 envsetup.sh 的绝对路径36
```37
38
配置完成后 bash 启动即可直接使用仓颉编译工具链。39
40
- 若使用 Windows 命令提示符（CMD）、PowerShell 或其他环境，可以根据如下步骤操作：41
42
1. 在 Windows 搜索框中，搜索 “查看高级系统设置” 并打开对应窗口；43
44
2. 单击 “环境变量” 按钮；45
46
3. 执行如下操作，配置 CANGJIE_HOME 变量：47
48
1. 在 “用户变量”（为当前用户进行配置）或 “系统变量”（为系统所有用户进行配置）区域中，查看是否已有 CANGJIE_HOME 环境变量。若没有，则单击 “新建” 按钮，并在 “变量名” 字段中输入 `CANGJIE_HOME` ；若有，则说明该环境可能已经进行过仓颉配置，如果想要继续为当前的仓颉版本进行配置并覆盖原配置，请单击 “编辑” 按钮，进入 “编辑系统变量” 窗口。49
50
2. 在 “变量值” 字段中输入仓颉安装包的解压路径，若原先已经存在路径，则使用新的路径覆盖原有的路径，例如仓颉安装包解压在 `D:\cangjie` ，则输入 `D:\cangjie` 。51
52
3. 配置完成后， “编辑用户变量” 或 “编辑系统变量” 窗口中显示的变量名为 `CANGJIE_HOME` 、变量值为 `D:\cangjie` 。确认路径正确配置后单击 “确定” 。53
54
4. 执行如下操作，配置 Path 变量：55
56
1. 在 “用户变量”（为当前用户进行配置）或 “系统变量”（为系统所有用户进行配置）区域中，找到并选择 Path 变量，单击 “编辑” 按钮，进入 “编辑环境变量” 窗口。57
58
2. 分别单击 “新建” 按钮，并分别输入 `%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` 。59
60
3. （仅适用于为当前用户设置）单击 “新建” 按钮，并输入当前用户目录路径，并在路径后面添加 `.cjpm\bin` 。例如用户路径在 `C:\Users\bob` ，则输入 `C:\Users\bob\.cjpm\bin` 。61
62
4. 配置完成后应能在 “编辑环境变量” 窗口中看到配置的路径如下所示。确认路径正确配置后单击 “确定” 。63
64
```text65
D:\cangjie\bin66
D:\cangjie\tools\bin67
D:\cangjie\tools\lib68
D:\cangjie\runtime\lib\windows_x86_64_llvm69
C:\Users\bob\.cjpm\bin70
```71
72
5. 单击 “确定” 按钮，退出 “环境变量” 窗口；73
74
6. 单击 “确定” 按钮，完成设置。75
76
> **注意：**77
>78
> 设置完成后可能需要重启命令行窗口或重启系统以让设置生效。79
80
配置完成后 Windows 命令提示符（CMD）或 PowerShell 启动即可直接使用仓颉编译工具链。v1.1.0
Section Text
1
在 Windows 平台上，仓颉为开发者提供了 `exe` 和 `zip` 两种格式的安装包，请前往仓颉官方发布渠道，选择和下载适配平台架构的 Windows 版安装包。2
3
- 如果选择 `exe` 格式的安装包（例如 `cangjie-sdk-windows-x64-x.y.z.exe`），请直接执行此文件，跟随安装向导点击操作，即可完成安装。4
5
- 如果选择 `zip` 格式的安装包（例如 `cangjie-sdk-windows-x64-x.y.z.zip`），请将它解压到适当目录，在安装包中，仓颉为开发者提供了三种不同格式的安装脚本，分别是 `envsetup.bat`，`envsetup.ps1` 和 `envsetup.sh`，可以根据使用习惯及环境配置，选择一种执行：6
7
- 若使用 Windows 命令提示符（CMD）环境，请执行：8
9
```bash10
path\to\cangjie\envsetup.bat11
```12
13
- 若使用 PowerShell 环境，请执行：14
15
```bash16
. path\to\cangjie\envsetup.ps117
```18
19
- 若使用 MSYS shell、bash 等环境，请执行：20
21
```bash22
source path/to/cangjie/envsetup.sh23
```24
25
为了验证是否安装成功，请在以上命令环境中继续执行 `cjc -v` 命令，如果输出了仓颉编译器版本信息，表示已经成功安装了仓颉工具链。26
27
**值得注意的是**，基于 zip 安装包和执行脚本的安装方式，类似于 Linux 平台，即 envsetup 脚本所配置的环境变量，只在当前命令行环境中有效，如果打开新的命令行窗口，需要重新执行 envsetup 脚本配置环境。此时，若想使仓颉工具链的环境变量配置在命令提示符或终端启动时自动生效，可以对系统进行如下配置：28
29
- 若使用 bash 环境，可以根据如下步骤操作：30
31
在 `$HOME/.bashrc` 初始化配置文件的最后加入以下命令（`$HOME` 为当前用户目录的路径）：32
33
```shell34
# 假设仓颉安装包解压在 /home/user/cangjie 中35
source /home/user/cangjie/envsetup.sh # 即 envsetup.sh 的绝对路径36
```37
38
配置完成后 bash 启动即可直接使用仓颉编译工具链。39
40
- 若使用 Windows 命令提示符（CMD）、PowerShell 或其他环境，可以根据如下步骤操作：41
42
1. 在 Windows 搜索框中，搜索 “查看高级系统设置” 并打开对应窗口；43
44
2. 单击 “环境变量” 按钮；45
46
3. 执行如下操作，配置 CANGJIE_HOME 变量：47
48
1. 在 “用户变量”（为当前用户进行配置）或 “系统变量”（为系统所有用户进行配置）区域中，查看是否已有 CANGJIE_HOME 环境变量。若没有，则单击 “新建” 按钮，并在 “变量名” 字段中输入 `CANGJIE_HOME` ；若有，则说明该环境可能已经进行过仓颉配置，如果想要继续为当前的仓颉版本进行配置并覆盖原配置，请单击 “编辑” 按钮，进入 “编辑系统变量” 窗口。49
50
2. 在 “变量值” 字段中输入仓颉安装包的解压路径，若原先已经存在路径，则使用新的路径覆盖原有的路径，例如仓颉安装包解压在 `D:\cangjie` ，则输入 `D:\cangjie` 。51
52
3. 配置完成后， “编辑用户变量” 或 “编辑系统变量” 窗口中显示的变量名为 `CANGJIE_HOME` 、变量值为 `D:\cangjie` 。确认路径正确配置后单击 “确定” 。53
54
4. 执行如下操作，配置 Path 变量：55
56
1. 在 “用户变量”（为当前用户进行配置）或 “系统变量”（为系统所有用户进行配置）区域中，找到并选择 Path 变量，单击 “编辑” 按钮，进入 “编辑环境变量” 窗口。57
58
2. 分别单击 “新建” 按钮，并分别输入 `%CANGJIE_HOME%\bin` 、 `%CANGJIE_HOME%\tools\bin` 、 `%CANGJIE_HOME%\tools\lib` 、 `%CANGJIE_HOME%\runtime\lib\windows_x86_64_cjnative` (`%CANGJIE_HOME%` 为仓颉安装包的解压路径)。例如，仓库安装包解压在 `D:\cangjie` ，则新建的环境变量分别为： `D:\cangjie\bin` 、 `D:\cangjie\tools\bin` 、 `D:\cangjie\tools\lib` 、 `D:\cangjie\runtime\lib\windows_x86_64_cjnative` 。59
60
3. （仅适用于为当前用户设置）单击 “新建” 按钮，并输入当前用户目录路径，并在路径后面添加 `.cjpm\bin` 。例如用户路径在 `C:\Users\bob` ，则输入 `C:\Users\bob\.cjpm\bin` 。61
62
4. 配置完成后应能在 “编辑环境变量” 窗口中看到配置的路径如下所示。确认路径正确配置后单击 “确定” 。63
64
```text65
D:\cangjie\bin66
D:\cangjie\tools\bin67
D:\cangjie\tools\lib68
D:\cangjie\runtime\lib\windows_x86_64_cjnative69
C:\Users\bob\.cjpm\bin70
```71
72
5. 单击 “确定” 按钮，退出 “环境变量” 窗口；73
74
6. 单击 “确定” 按钮，完成设置。75
76
> **注意：**77
>78
> 设置完成后可能需要重启命令行窗口或重启系统以让设置生效。79
80
配置完成后 Windows 命令提示符（CMD）或 PowerShell 启动即可直接使用仓颉编译工具链。