配置 Cangjie 编程语言的开发环境

jetsung

配置 Cangjie 编程语言的开发环境

此教程基于日更版仓库说明。

仓颉编程语言 SDK

https://atomgit.com/Cangjie/nightly_build/releases

一、下载 cangjie sdk

下载不带 sanitizer 的版本，除非需要开发 cangjie 编程语言本身。

下载地址	包大小
`cangjie-sdk-linux-x64-1.1.0-alpha.20260307010001-sanitizer.tar.gz`	471.0MB
`cangjie-sdk-linux-x64-1.1.0-alpha.20260307010001.tar.gz`	385.6MB

这两个包都是仓颉编程语言（Cangjie）的 Linux x64 SDK alpha 版本（同一个构建时间：20260307010001），区别主要在于是否内置了 sanitizer（内存/行为检查工具）。

cangjie-sdk-linux-x64-1.1.0-alpha.20260307010001.tar.gz
普通版本（release build），体积较小：385.6MB
适合日常开发、编译、运行程序，性能最好。
cangjie-sdk-linux-x64-1.1.0-alpha.20260307010001-sanitizer.tar.gz
带 sanitizer 插桩的调试版本（通常是 AddressSanitizer + 可能还有 UndefinedBehaviorSanitizer 等），体积较大：471.0MB
主要用于找内存错误（use-after-free、buffer overflow）、未定义行为等 bug，运行时会明显变慢（通常 2–10 倍），内存占用也更高。

简单总结对比：

项目	普通版 (.tar.gz)	sanitizer 版 (-sanitizer.tar.gz)
文件大小	385.6 MB	471.0 MB（多了 ₈₅ MB）
主要用途	日常开发、性能测试	找内存越界、野指针、UB 等严重 bug
运行速度	正常	明显变慢
内存占用	正常	显著增加
推荐场景	写代码、跑 benchmark	CI 里的 asan 测试、本地 debug 崩溃问题

建议使用方式：

平时开发 → 用小的那个（无-sanitizer）
遇到诡异崩溃、段错误、疑似内存问题 → 换 sanitizer 版重新编译运行，程序会在出错的地方直接报详细的 asan 信息（栈踪迹 + 具体哪一行越界/释放后使用等）

二、安装

tar -zxvf cangjie-sdk*.tar.gz -C ~/.local/

三、配置环境变量

$HOME/.bashrc

# Cangjie
export CANGJIE_HOME=$HOME/.local/cangjie
if [[ -f "$CANGJIE_HOME/envsetup.sh" ]]; then
  source "$CANGJIE_HOME/envsetup.sh"
fi

仓颉编程语言扩展库

一、下载扩展库

cangjie-stdx-linux-x64-1.1.0-alpha.20260307010001.1.zip

二、安装

安装至 ~/.local/share/cangjie

mkdir -p ~/.local/share/cangjie
unzip cangjie-stdx*.zip -d ~/.local/share/cangjie

三、配置环境变量

$HOME/.bashrc

## Cangjie stdx
export CANGJIE_STDX_PATH=$HOME/.local/share/cangjie/linux_x86_64_cjnative/dynamic/stdx
if [[ -d "$CANGJIE_STDX_PATH" ]]; then
  export LD_LIBRARY_PATH=$CANGJIE_STDX_PATH:$LD_LIBRARY_PATH
fi
export CANGJIE_STDX_STATIC_PATH=$HOME/.local/share/cangjie/linux_x86_64_cjnative/static/stdx

jetsung

解决仓颉环境配置导致系统工具（git）库冲突的方案

1. 问题现象

在配置完仓颉（Cangjie）开发环境并加载其 envsetup.sh 脚本后，运行系统命令（如 git --version）时出现如下错误：

git: /home/user/.local/cangjie/runtime/lib/linux_x86_64_cjnative/libpcre2-8.so.0: no version information available (required by git)

同时 cjc --version 等仓颉自带工具运行正常。

2. 原因分析

仓颉官方提供的环境初始化脚本 envsetup.sh 会将仓颉运行时的库路径（如 runtime/lib/...）前置到环境变量 LD_LIBRARY_PATH 中。

由于仓颉自带了 libpcre2-8.so.0 等库，且这些库与系统原生工具（如 Fedora/Ubuntu 下的 git）依赖的版本不一致或缺少版本信息，导致系统加载器（ld.so）优先加载了仓颉目录下的库，从而引发冲突。

3. 解决方案

核心思路

在加载仓颉环境变量后，手动将系统的标准库路径（如 /lib64 和 /usr/lib64）重新前置到 LD_LIBRARY_PATH 的最前面。这样可以确保系统原生工具优先使用其自带的兼容库，而仓颉编译器及其工具（如 cjpm）依然能在路径后续部分找到其所需的运行时库。

操作步骤

定位配置文件：
找到你存放环境变量配置的文件（通常是 ~/.bashrc、~/.zshrc 或项目中的 dev-path.sh）。

修改配置逻辑：
在执行 source $CANGJIE_HOME/envsetup.sh 之后，添加修复逻辑。

修改前：

   export CANGJIE_HOME=$HOME/.local/cangjie
   if [[ -f "$CANGJIE_HOME/envsetup.sh" ]]; then
     source "$CANGJIE_HOME/envsetup.sh"
   fi

修改后（推荐）：

   export CANGJIE_HOME=$HOME/.local/cangjie
   if [[ -f "$CANGJIE_HOME/envsetup.sh" ]]; then
     source "$CANGJIE_HOME/envsetup.sh"
     
     # 修复 LD_LIBRARY_PATH 冲突：
     # 将系统标准库路径前置，确保系统工具（如 git）优先加载其自身的库（如 libpcre2）
     if [[ ":$LD_LIBRARY_PATH:" != *":/lib64:"* ]]; then
       export LD_LIBRARY_PATH="/lib64:/usr/lib64:$LD_LIBRARY_PATH"
     fi
   fi

4. 方案验证

执行 source 使配置生效后进行检查：

验证系统工具：

  git --version
  # 应正常输出版本号，不再报错

验证仓颉编译器：

  cjc --version
  # 应正常显示仓颉编译器版本

5. 补充说明

通用性：该方案适用于大多数 Linux 发行版（如 Fedora, Ubuntu, Arch），因为 /lib64 或 /usr/lib64 是 64 位系统存放核心动态链接库的标准路径。
稳定性：通过 if 判断避免了路径在多次 source 时重复叠加。