Skip to content

ystyle/cjvs

BranchesTags

Repository files navigation

cjvs

仓颉版本管理工具，类似nvm，目前支持linux、macos、windows平台。linux 解压 tar.gz 格式依赖系统 tar 命令

更新日志:

  • 2026-03-24 v0.3.6 升级到 Cagnjie 1.1.0, 现在可以直接使用cjpm install cjvs-0.3.6 来下载
  • 2025-12-30 v0.3.0 升级到 Cangjie 1.0.0，新增 stdx 管理功能，支持静态/动态库切换，支持 macOS 平台
  • 2025-08-24 windows 也能使用了， 并新增了elvish和nushell的支持
  • 2025-07-04 因为添加了不同的shell进程，可切换不同版本的功能，当前widnows 版本暂时不可用
  • 2025-03-30 初步支持了windows(powershell), 可以自己手工编译试用

功能

  • 列出可在线安装的官方发布版本
  • 在线安装官方发布版本
  • 离线安装zip/tar.gz版本(需要按官方的目录结构，可离线安装内测版本)
  • 列出已安装的版本
  • 在每个shell/或者终端模拟器页签中切换并使用不同的仓颉版本
  • 设置默认的仓颉版本
  • 删除cjvs安装的版本
  • 管理 stdx 扩展库：安装、切换、删除 stdx 版本，支持静态/动态库切换
  • 多 Shell 支持：bash、zsh、fish、nushell、elvish、powershell

安装

  1. Archlinux
  • 如果使用 Archlinux 可以使用 paru -S cjvs-bin 安装

本仓库 Release 里的 linux-amd64 版本是在 archlinux 构建的，在较老的 linux 发行版可能不支持。

  1. Widnows, Linux, MacOS 使用cjpm安装
  • 需要安装 1.1.0+ 版本的 cangjie编译器 和 stdx，然后设置环境变量: export CANGJIE_STDX_PATH=path_to_stdx/1.1.0/
  • 执行cjpm install cjvs-0.3.6

设置

Linux

linux下默认会安装仓颉版本到~/.config/cjvs目录

需要安装OpenSsl ，仓颉网络库依赖openssl

  1. 手动安装时需要把cjvs放path环境变量里
export PATH=$PATH:/path/to/cjvs
  1. 添加shell配置，按使用的bash或zsh添加以下配置
# zsh
eval "$(cjvs env zsh)"

# bash
eval "$(cjvs env bash)"

# nushell： 这两行
cjvs env nushell | save -f ~/.cjvs.nu
use ~/.cjvs.nu

# fish
cjvs env fish | source

# elvish 
eval (cjvs.exe env elvish | slurp)

Windows

  • 编译安装好后，把以下文件放到一个目录，并添加到Path环境变量
    • cjvs.exe
    • libcangjie-runtime.dll: 来自$CANGJIE_HOME\runtime\lib\windows_x86_64_llvm\libcangjie-runtime.dll
    • libsecurec.dll: 来自$CANGJIE_HOME\runtime\lib\windows_x86_64_llvm\libsecurec.dll
  • 找到并打开自己的 PowerShell 启动脚本, 可以执行$PSVersionTable.PSVersion查看版本
    • PowerShell 5： %userprofile%\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1
    • PowerShell 6/7：%userprofile%\Documents\PowerShell\Microsoft.PowerShell_profile.ps1
  • 并添加以下内容(创建软件连接需要管理员权限，所以配置成只在有管理员权限时才加载cjvs提供的环境)：
# 仅在管理员会话里加载 cjvs
if ([Security.Principal.WindowsPrincipal]::new(
        [Security.Principal.WindowsIdentity]::GetCurrent()
    ).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)
) {
    cjvs.exe env powershell | Out-String | Invoke-Expression
}
  • 以管理员身份启动, 可以正常执行cjvs命令了， 如cjvs.exe install 1.0.0
在非管理员 PowerShell 使用
  • 需要在【设置 - 更新和安全 - 开发者选项 - 开发人员模式】启用， 然后重启系统， 然后在上述文件添加的内容改成只要最后一行添加cjvs.exe env powershell | Out-String | Invoke-Expression
  • 如果还提示需要管理员权限， 在【secpol.msc → 本地策略 → 用户权限分配 → 创建符号链接 】添加当前登录用户，再重启系统试试。
  • 如果都不行，就只能回退到上小节，只在管理员会话里加载使用了。

使用

$ cjvs
Usage: cjvs [options...]
  list, ls        List Cangjie installations.
  ls-remote, rls  List all remote Cangjie versions.
                    eg:
                      cjvs rls                                     # List all versions
                      cjvs rls sts                                 # List STS versions only
                      cjvs rls sts --beta                          # List STS versions with beta
  install, i      Install a new Cangjie version.
                    eg:
                      cjvs install 0.53.13 # install online
                      cjvs install 0.59.6 ~/Downloads/cangjie-0.59.6-linux_x64.tar.gz # install a local version
  switch, use     Switch to use the specified version.
  default         Set the default Cangjie version.
  remove, rm      Remove a specific version.
  env             Print and set up required environment variables for cjvs
  stdx            Manage stdx (extension library) versions.
                    eg:
                      cjvs stdx list                              # List installed stdx versions
                      cjvs stdx install 1.0.0 ~/Downloads/stdx.zip # Install stdx from local zip
                      cjvs stdx use 1.0.0                          # Switch stdx version
                      cjvs stdx use 1.0.0 static                   # Switch with static library
                      cjvs stdx default 1.0.0                      # Set default stdx version
                      cjvs stdx default 1.0.0 dynamic              # Set default with dynamic library
                      cjvs stdx config static                      # Set default library type
                      cjvs stdx remove 1.0.0                       # Remove stdx version
  stdx-env        Generate stdx environment variables for current shell.
                    eg:
                      cjvs stdx-env zsh                            # Generate env for zsh
                      cjvs stdx-env bash                           # Generate env for bash

GLOBAL OPTIONS:
  --help, -h     show help
  --version, -v  print the version

示例

  • 显示可用STS版本

    $ cjvs rls            
Channel: sts
      0.53.13
      0.53.18
      1.1.0
      1.1.0-android
      1.1.0-ohos

  • 显示可用STS版本（含 beta）

    $ cjvs rls sts --beta
Channel: sts
      0.53.13
      0.53.18
      1.1.0
      1.1.0-android
      1.1.0-ohos
      beta:
              1.1.0-beta.23
              1.1.0-beta.24
              1.1.0-beta.25

  • 在线安装版本，第一次安装的版本会被设置为默认版本

    $ cjvs install 0.53.13
installing 0.53.13...
installed.
0.53.13 is set as default.

  • 安装本地压缩版本（zip/tar.gz的目录结构需要和官方提供的一致）

    $ cjvs install 0.59.6 ~/Downloads/cangjie-0.59.6-linux_x64.tar.gz
installing 0.59.6...
installed.

  • 设置启动shell时默认的版本

    $ cjvs default 0.53.13

  • 显示本地已经安装的仓颉版本

    $ cjvs ls
Installed Cangjie versions(makr up * is in used):
	  std_0.31.4
	  jet_0.33.3
	  std_0.32.5
	* std_0.33.3

  • 切换版本, 可以切换当前shell进程(或终端模拟器的页签)的仓颉版本，每个shell进程可以有不同的版本。

    $ cjvs switch std_0.33.3
Switch success
Now using version: std_0.33.3

    mult shell

  • 手动添加版本:

    • 把仓颉编译器版本复制到$HOME/.config/cjvs/store目录
      • 如 $HOME/.config/cjvs/store/std_0.33.3， 该目录直接包含bin、lib、runtime、tools、modules等目录
      ~/.config/cjvs$ tree -L 3
.
└── store
    └── cangjie_0.33.3
        ├── bin
        ├── debugger
        ├── docs
        ├── envsetup.sh
        ├── lib
        ├── modules
        ├── runtime
        ├── third_party
        └── tools

10 directories, 1 file

stdx 管理

stdx 是仓颉的扩展库，包含预编译的静态库和动态库。cjvs 提供了完整的 stdx 管理功能。

stdx 命令

$ cjvs stdx
Usage: cjvs stdx <list|install|use|default|config|remove> [args]

子命令:
  list, ls              列出已安装的 stdx 版本
  install, i <version> <zip-file>  安装 stdx 版本（从本地 zip 文件）
  use <version> [static|dynamic]   切换当前使用的 stdx 版本
  default <version> [static|dynamic] 设置默认 stdx 版本
  config <static|dynamic>          设置默认库类型
  remove, rm <version>             删除 stdx 版本

stdx 使用示例

# 安装 stdx（从本地 zip 文件）
$ cjvs stdx install 1.0.0 ~/Downloads/stdx-1.0.0.zip

# 列出已安装的 stdx 版本
$ cjvs stdx ls

# 设置默认版本为 1.0.0，使用动态库
$ cjvs stdx default 1.0.0

# 设置默认版本为 1.0.0，使用静态库
$ cjvs stdx default 1.0.0 static

# 切换当前版本为 1.0.0，使用动态库
$ cjvs stdx use 1.0.0

# 只修改默认库类型为 static（不改变版本）
$ cjvs stdx config static

# 删除指定版本
$ cjvs stdx remove 0.9.0

在环境中启用 stdx

使用 stdx-env 命令（推荐）

stdx-env 命令专门用于设置 stdx 环境变量，直接使用实际路径，不依赖符号链接：

# bash/zsh
eval "$(cjvs stdx-env zsh)"
eval "$(cjvs stdx-env bash)"

# 或使用子命令形式
eval "$(cjvs stdx env zsh)"

# nushell
cjvs stdx-env nushell | save -f ~/.cjvs-stdx.nu
use ~/.cjvs-stdx.nu

# fish
cjvs stdx-env fish | source

# elvish
eval (cjvs stdx-env elvish | slurp)
使用 `-stdx` 参数（当前不可用，点击展开）

⚠️ 注意：由于 cjpm 当前版本不支持读取符号链接，此方式暂不可用。官方已将其作为需求处理，等待修复后可启用。

使用 -stdx 参数启用 stdx 环境变量：

# bash/zsh
eval "$(cjvs env bash -stdx)"

# nushell
cjvs env nushell -stdx | save -f ~/.cjvs.nu
use ~/.cjvs.nu

# elvish
eval (cjvs env elvish -stdx | slurp)

这会设置 CANGJIE_STDX_PATH 环境变量，指向当前选择的 stdx 版本和库类型（static/dynamic）。

两种方式的区别：

  • cjvs stdx-env <shell>：直接使用实际路径，兼容所有版本的 cjpm，推荐使用
  • cjvs env <shell> -stdx：使用符号链接，当前 cjpm 版本不支持，暂不可用

env 命令参数

cjvs env 命令支持以下参数：

cjvs env <shell> [options]

选项:
  -no-ld-library-path 不设置 LD_LIBRARY_PATH 环境变量

使用示例

# 基础用法
eval "$(cjvs env bash)"

# 不设置 LD_LIBRARY_PATH（某些情况下可能需要）
eval "$(cjvs env bash -no-ld-library-path)"

cjenv 快捷函数

bash/zsh 和 elvish 会自动定义 cjenv 函数，用于快速设置库路径：

# 在 shell 中手动调用 cjenv 更新库路径
cjenv

这会更新 LD_LIBRARY_PATH 指向当前 $CANGJIE_HOME 的运行时库路径。

许可证

MIT License

About

仓颉(Cangjie)的版本切换工具

Resources

Readme

License

MIT license
Activity

Stars

6 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases 18

v0.3.9 Latest
Apr 26, 2026
+ 17 releases

Packages

 
 
 

Contributors

Languages