仓颉 (Cangjie) 工具链在 openEuler 上的安装与使用指南
仓颉 (Cangjie) 工具链在 openEuler 上的安装与使用指南
记录时间:2026-10-29
工具链版本:Cangjie STS 1.2.0
目标平台:Linux aarch64 (ARM64)
运行环境:openEuler 22.03 LTS, Linux Kernel 5.10.0, glibc 2.34
一、环境信息
1.1 当前系统环境
| 项目 | 值 |
|---|---|
| 操作系统 | openEuler 22.03 LTS |
| 内核版本 | 5.10.0-182.0.0.95.r3353_274.hce2.aarch64 |
| 架构 | aarch64 (ARM64) |
| glibc 版本 | 2.34 |
| libstdc++ 版本 | GLIBCXX_3.4.28 (对应 libstdc++ 6.0.28) |
| OpenSSL 版本 | 1.1.1m(系统自带;仓颉推荐 OpenSSL 3,但基本编译运行不受影响) |
| 磁盘可用空间 | 153GB |
1.2 仓颉工具链系统要求(aarch64 Linux)
| 要求 | 最低版本 | 当前环境 | 状态 |
|---|---|---|---|
| glibc | 2.27 | 2.34 | ✅ 满足 |
| Linux Kernel | 4.15 | 5.10.0 | ✅ 满足 |
| libstdc++ | 6.0.24 | 6.0.28 | ✅ 满足 |
| OpenSSL | 3(推荐) | 1.1.1m | ⚠️ 版本偏低,基本功能可用 |
二、下载仓颉工具链
2.1 获取下载链接
仓颉工具链的官方下载页面位于:内容中超链接不在白名单中
请访问仓颉官网下载页面
该页面提供三个版本通道:
- LTS Version(长期稳定版):当前为 1.0.5
- STS Version(半年更新版):当前为 1.2.0
- Nightly Builds(每日构建版):通过 GitCode 发布
本次安装选择 STS 1.2.0 版本。
2.2 下载地址
STS 1.2.0 版本 Linux aarch64 的下载 API:
内容中超链接不在白名单中
2.3 文件信息
| 项目 | 值 |
|---|---|
| 文件名 | cangjie-sdk-linux-aarch64-1.2.0.tar.gz |
| 文件大小 | 193.27 MB (202,655,582 bytes) |
| SHA256 | 40e3962472d6d1b181e685198b193b904a385ac8dbbdff8aa9c52c4bb6f6e0f1 |
| 发布日期 | 2026-09-22 |
2.4 下载命令
# 创建下载目录
mkdir -p /tmp/cangjie-download
# 下载 SDK
2.5 校验文件完整性
# 验证 SHA256
echo "Expected: 40e3962472d6d1b181e685198b193b904a385ac8dbbdff8aa9c52c4bb6f6e0f1"
sha256sum /tmp/cangjie-download/cangjie-sdk-linux-aarch64-1.2.0.tar.gz
# 输出应为:40e3962472d6d1b181e685198b193b904a385ac8dbbdff8aa9c52c4bb6f6e0f1
三、安装与配置
3.1 解压工具链
# 解压到 /opt/cangjie 目录
mkdir -p /opt/cangjie
cd /opt/cangjie
tar xvf /tmp/cangjie-download/cangjie-sdk-linux-aarch64-1.2.0.tar.gz
解压后目录结构:
/opt/cangjie/cangjie/
├── LICENSE # 许可证文件
├── Open_Source_Software_Notice.docx # 开源软件声明
├── bin/ # 编译器二进制(cjc, cjc-frontend)
├── envsetup.sh # 环境变量配置脚本
├── lib/ # 编译器库文件
├── modules/ # 标准库模块
├── runtime/ # 运行时库
│ └── lib/
│ └── linux_aarch64_cjnative/ # aarch64 Linux 原生运行时
├── third_party/ # 第三方依赖
└── tools/ # 工具链
├── bin/ # cjpm, cjfmt, cjlint, cjdb, cjcov 等工具
└── lib/ # 工具库文件
3.2 配置环境变量
仓颉工具链提供了 envsetup.sh 脚本,用于自动配置环境变量:
# 在当前 shell 中配置环境(每次新开终端需重新执行)
source /opt/cangjie/cangjie/envsetup.sh
该脚本设置了以下环境变量:
| 环境变量 | 值 | 说明 |
|---|---|---|
CANGJIE_HOME |
/opt/cangjie/cangjie |
仓颉 SDK 安装目录 |
PATH |
追加 $CANGJIE_HOME/bin、$CANGJIE_HOME/tools/bin、$HOME/.cjpm/bin |
可执行文件搜索路径 |
LD_LIBRARY_PATH |
追加 $CANGJIE_HOME/runtime/lib/linux_aarch64_cjnative、$CANGJIE_HOME/tools/lib |
动态库搜索路径 |
3.3 持久化配置(可选)
若希望每次打开终端自动加载仓颉环境,可将以下命令添加到 ~/.bashrc:
echo 'source /opt/cangjie/cangjie/envsetup.sh' >> ~/.bashrc
3.4 验证安装
source /opt/cangjie/cangjie/envsetup.sh
# 验证编译器
cjc -v
# 输出:
# Cangjie Compiler: 1.2.0 (cjnative)
# Target: aarch64-unknown-linux-gnu
# 验证包管理器
cjpm -v
# 输出:
# Cangjie Project Manager: 1.2.0
四、创建 Hello World 项目
4.1 初始化项目
# 创建项目目录
mkdir -p ~/workspace/cangjie/projects/HelloWorld
cd ~/workspace/cangjie/projects/HelloWorld
# 使用 cjpm 初始化项目
source /opt/cangjie/cangjie/envsetup.sh
cjpm init
cjpm init 会自动创建以下文件:
HelloWorld/
├── cjpm.toml # 项目配置文件
└── src/
└── main.cj # 源代码文件
4.2 项目配置文件 (cjpm.toml)
[package]
cjc-version = "1.2.0"
name = "HelloWorld"
organization = ""
description = "nothing here"
version = "1.0.0"
target-dir = ""
script-dir = ""
output-type = "executable"
compile-option = ""
override-compile-option = ""
link-option = ""
package-configuration = {}
[dependencies]
4.3 源代码 (src/main.cj)
package HelloWorld
main(): Int64 {
println("Hello, World!")
return 0
}
代码说明:
package HelloWorld:声明当前包名为 HelloWorld,必须与 cjpm.toml 中的 name 一致main(): Int64:程序入口函数,返回 64 位整数(类似 C 的int main())println("Hello, World!"):打印字符串到标准输出并换行return 0:返回 0 表示程序正常退出
五、编译与运行
5.1 编译项目
cd ~/workspace/cangjie/projects/HelloWorld
source /opt/cangjie/cangjie/envsetup.sh
cjpm build
# 输出:cjpm build success
编译产物位于 target/release/bin/ 目录下:
target/
└── release/
└── bin/
├── HelloWorld.cjo # 仓颉目标文件
└── main # 可执行文件(原生二进制)
5.2 运行程序
./target/release/bin/main
# 输出:Hello, World!
5.3 查看可执行文件信息
file ./target/release/bin/main
# 输出:ELF 64-bit LSB pie executable, ARM aarch64, version 1 (SYSV),
# dynamically linked, interpreter /lib/ld-linux-aarch64.so.1,
# for GNU/Linux 3.7.0, not stripped
ls -lh ./target/release/bin/main
# 输出:-rwxr-xr-x 1 root root 1.1M ... main
六、编译目标与运行环境说明
6.1 仓颉编译器支持的目标平台
仓颉编译器 (cjc) 支持多目标编译,通过 --target 参数指定:
| 目标 | 说明 |
|---|---|
aarch64-unknown-linux-gnu |
Linux ARM64(当前环境默认目标) |
x86_64-unknown-linux-gnu |
Linux x86_64 |
aarch64-apple-darwin |
macOS ARM64 |
x86_64-apple-darwin |
macOS x86_64 |
x86_64-pc-windows-gnu |
Windows x86_64 (MinGW) |
| 鸿蒙目标 | HarmonyOS NEXT(需鸿蒙 SDK) |
6.2 本次编译的运行环境
本次编译的程序运行在 Linux 环境下:
- 编译后端:CJNative(编译为原生机器码,非字节码)
- 目标三元组:
aarch64-unknown-linux-gnu - 二进制格式:ELF 64-bit,ARM aarch64,动态链接
- 运行平台:Linux(openEuler 22.03 LTS)
- 不是鸿蒙 OS,不是 Windows
6.3 仓颉的跨平台能力
仓颉语言支持"同构开发、异构运行":
- 同一份仓颉源代码,通过指定不同的
--target,可以编译为不同平台的可执行文件 - 在 Linux 上可以编译出 Linux 原生程序
- 在鸿蒙 DevEco Studio 中可以编译出鸿蒙应用
- 仓颉编译器本身是静态编译至机器码的,不依赖虚拟机(CJNative 后端)
七、仓颉工具链包含的工具
| 工具 | 说明 |
|---|---|
cjc |
仓颉编译器,将 .cj 源码编译为二进制 |
cjc-frontend |
编译器前端 |
cjpm |
仓颉项目包管理器(类似 cargo/maven) |
cjfmt |
代码格式化工具 |
cjlint |
静态检查工具 |
cjdb |
调试器 |
cjcov |
覆盖率统计工具 |
cjprof |
性能分析工具 |
八、常见问题
Q1: OpenSSL 版本不满足要求怎么办?
仓颉工具链推荐 OpenSSL 3,但系统自带的是 OpenSSL 1.1.1m。对于基本的编译和运行(如 Hello World),OpenSSL 1.1.1m 可以正常工作。如果遇到依赖问题,可以通过以下方式安装 OpenSSL 3:
# openEuler 安装 OpenSSL 3
yum install -y openssl3 2>/dev/null || dnf install -y openssl3 2>/dev/null
Q2: 新开终端后 cjc 命令找不到?
envsetup.sh 只在当前 shell 生效。新开终端需要重新执行:
source /opt/cangjie/cangjie/envsetup.sh
或将其添加到 ~/.bashrc 实现持久化。
Q3: 编译后的程序可以在其他 Linux 机器上运行吗?
可以,但目标机器需要满足以下条件:
- 相同的架构(aarch64)
- glibc 版本 >= 2.27
- 安装了仓颉运行时库(或将运行时库路径加入 LD_LIBRARY_PATH)
Q4: 仓颉程序可以编译为鸿蒙应用吗?
可以,但需要鸿蒙 DevEco Studio 和鸿蒙 SDK。在 Linux 上使用仓颉工具链编译的是 Linux 原生程序,不是鸿蒙应用。鸿蒙应用开发需要在鸿蒙开发环境中进行。
Q5: 编译和运行时报错解决办法
安装依赖工具
dnf install glibc-devel gcc gcc-c++ binutils -y
九、相关链接
| 资源 |
|---|
| 仓颉官网 |
| 下载页面 |
| 开发指南 |
| 中心仓(三方库) |
| Nightly 构建仓库 |
| 仓颉开源仓库 |
| VS Code 插件 |
十、完整操作命令汇总
# 1. 下载 SDK
mkdir -p /tmp/cangjie-download
内容中超链接不在白名单中 请访问仓颉官网下载页面下载SDK
# 2. 校验 SHA256
sha256sum /tmp/cangjie-download/cangjie-sdk-linux-aarch64-1.2.0.tar.gz
# 应输出:40e3962472d6d1b181e685198b193b904a385ac8dbbdff8aa9c52c4bb6f6e0f1
# 3. 解压
mkdir -p /opt/cangjie
cd /opt/cangjie
tar xvf /tmp/cangjie-download/cangjie-sdk-linux-aarch64-1.2.0.tar.gz
# 4. 配置环境
source /opt/cangjie/cangjie/envsetup.sh
# 5. 验证安装
cjc -v # Cangjie Compiler: 1.2.0 (cjnative), Target: aarch64-unknown-linux-gnu
cjpm -v # Cangjie Project Manager: 1.2.0
# 6. 创建项目
mkdir -p ~/workspace/cangjie/projects/HelloWorld
cd ~/workspace/cangjie/projects/HelloWorld
cjpm init
# 7. 编译
cjpm build
# 8. 运行
./target/release/bin/main
# 输出:Hello, World!
- 点赞
- 收藏
- 关注作者
评论(0)