仓颉 (Cangjie) 工具链在 openEuler 上的安装与使用指南

举报
yd_226720226 发表于 2026/10/30 05:30:21 2026/10/30
【摘要】 在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!
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。