安装仓颉工具链（Mac版本）

徐建国

发布于 2025-11-29 14:27:54

130

文章被收录于专栏：个人路线个人路线

安装仓颉工具链（Mac版本）

📖 本文档将指导您完成仓颉编程语言工具链的安装配置

仓颉编程语言是华为面向全场景应用开发的通用编程语言，支持多种操作系统平台。本文以mac为例

📋 系统要求

支持的操作系统

操作系统	架构	最低版本	推荐版本
macOS	aarch64 (M1/M2)	macOS 12.0	macOS 14.0+
Linux	x86_64	Ubuntu 20.04	Ubuntu 22.04+
Linux	aarch64	Ubuntu 20.04	Ubuntu 22.04+
Windows	x86_64	Windows 10	Windows 11

硬件要求

内存：至少 4GB RAM，推荐 8GB+
存储：至少 2GB 可用空间
处理器：支持 64 位架构

🚀 快速开始

🍎 macOS 安装指南

📋 前置要求

系统版本：macOS 12.0 及以上版本
架构支持：aarch64 (Apple Silicon M1/M2)
包管理器：Homebrew（推荐）

🔧 安装依赖

在安装仓颉工具链之前，需要先安装必要的依赖软件包：

# 安装 libffi 依赖库
brew install libffi

jianguo@Mac cangjie % brew install libffi
==> Auto-updating Homebrew...
Adjust how often this is run with `$HOMEBREW_AUTO_UPDATE_SECS` or disable with
`$HOMEBREW_NO_AUTO_UPDATE=1`. Hide these hints with `$HOMEBREW_NO_ENV_HINTS=1` (see `man brew`).
==> Fetching downloads for: libffi
==> Fetching libffi
==> Downloading https://mirrors.aliyun.com/homebrew/homebrew-bottles/libffi-3.4.
######################################################################### 100.0%
==> Pouring libffi-3.4.8.arm64_sequoia.bottle.tar.gz
==> Caveats
libffi is keg-only, which means it was not symlinked into /opt/homebrew,
because macOS already provides this software and installing another version in
parallel can cause all kinds of trouble.

For compilers to find libffi you may need to set:
export LDFLAGS="-L/opt/homebrew/opt/libffi/lib"
export CPPFLAGS="-I/opt/homebrew/opt/libffi/include"
==> Summary
🍺  /opt/homebrew/Cellar/libffi/3.4.8: 18 files, 787.9KB
==> Running `brew cleanup libffi`...
Disable this behaviour by setting `HOMEBREW_NO_INSTALL_CLEANUP=1`.
Hide these hints with `HOMEBREW_NO_ENV_HINTS=1` (see `man brew`).
==> No outdated dependents to upgrade!
jianguo@Mac cangjie %

📦 下载仓颉工具链

步骤 1：访问官网下载

前往仓颉官网下载页面下载适配您平台的安装包：

仓颉工具链下载页面

步骤 2：选择合适的安装包

平台	架构	安装包名称
macOS	aarch64	cangjie-sdk-mac-aarch64-x.y.z.tar.gz
Linux	x86_64	cangjie-sdk-linux-x64-x.y.z.tar.gz
Linux	aarch64	cangjie-sdk-linux-aarch64-x.y.z.tar.gz

🛠️ 安装步骤

步骤 1：解压安装包

# 解压下载的安装包（以 macOS 为例）
tar xvf cangjie-sdk-mac-aarch64-1.0.1.tar.gz

解压完成后，您会看到一个名为 cangjie 的目录，其中包含了仓颉工具链的所有文件。

步骤 2：配置环境变量

# 配置仓颉工具链环境变量
source cangjie/envsetup.sh

步骤 3：验证安装

# 检查编译器版本
cjc -v

预期输出示例：

jianguo@Mac cangjie % source cangjie/envsetup.sh
jianguo@Mac cangjie % cjc -v
Cangjie Compiler: 1.0.1 (cjnative)
Target: aarch64-apple-darwin

如果看到类似的版本信息输出，说明仓颉工具链已成功安装！

🔧 环境配置

临时环境配置

上述 envsetup.sh 脚本仅在当前 shell 环境中生效。如果需要在新的终端窗口中使用仓颉工具链，需要重新执行配置脚本。

永久环境配置

为了让仓颉工具链在每次启动终端时自动可用，可以将配置命令添加到 shell 初始化文件中：

对于 zsh（macOS 默认）：

# 编辑 ~/.zshrc 文件
echo 'source /path/to/cangjie/envsetup.sh' >> ~/.zshrc

对于 bash：

# 编辑 ~/.bashrc 文件
echo 'source /path/to/cangjie/envsetup.sh' >> ~/.bashrc

实际示例：

# 假设仓颉工具链解压在 /Users/jianguo/Desktop/cangjie/ 目录下
echo 'source /Users/jianguo/Desktop/cangjie/cangjie/envsetup.sh' >> ~/.zshrc

配置完成后，重新启动终端或执行 source ~/.zshrc 即可生效。

🗑️ 卸载与更新

卸载仓颉工具链

rm -rf /path/to/cangjie

移除环境变量配置：

# 编辑 ~/.zshrc 或 ~/.bashrc，删除相关的 source 命令行
vim ~/.zshrc

重新加载配置：

source ~/.zshrc

更新仓颉工具链

更新仓颉工具链需要先卸载当前版本，然后重新安装最新版本：

按照上述步骤卸载当前版本
从官网下载最新版本的安装包
按照安装步骤重新安装

🚀 第一个仓颉程序

安装完成后，让我们创建并运行第一个仓颉程序：

📝 创建 Hello World

mkdir hello-cangjie
cd hello-cangjie

创建源文件

// hello.cj
main() {
    println("你好，仓颉")
}

编译运行

# 编译
cjc main.cj

# 运行
./main

预期输出：

Hello, 仓颉!

恭喜！您已经成功安装仓颉工具链并运行了第一个程序！

📚 参考资源

🌐 官方资源

资源名称	链接	描述
仓颉官网	https://cangjie-lang.cn/	官方文档和下载
仓颉 GitCode	https://gitcode.com/cangjie	官方代码仓库
仓颉三方库	https://gitcode.com/cangjie-tpc	第三方库生态
仓颉 SIG	https://gitcode.com/cangjie-sig	特别兴趣小组