命令参考

用 cjv <command> --help 查看本机版本的帮助。名称格式见工具链与版本，选择顺序见项目工具链。

全局选项

显式 --toolchain 优先于全局 +name。exec 和 envsetup 也接受子命令后的 +name。子进程参数由 run、exec 原样传递，退出码也会保留。

安装、更新与卸载

install

cjv install [toolchain]... [-t target]... [-c component]... [--force | --no-update] [--allow-downgrade]

install 省略名称时安装当前选择，指定多个名称时逐项处理。-t/--target 和 -c/--component 可重复或逗号分隔。

安装多个通道，或在安装时添加组件：

cjv install lts sts
cjv install nightly -c stdx,docs

安装与更新策略

没有新增组件或目标需求时，install --no-update 可离线完成。

update

cjv update [toolchain]... [--force] [--allow-downgrade] [--no-self-update]

update 指定名称时处理这些工具链；无名称时使用全局 +name，否则更新所有已跟踪通道。具体版本保持固定，自定义工具链没有官方更新。只有全量更新会按 auto_self_update 检查或更新 cjv，--no-self-update 可跳过。

通道升级会先准备宿主 SDK、已跟踪目标和组件，全部准备完成后替换安装。失败时保留或恢复原安装，固定版本独立保留。

cjv update lts
cjv update --no-self-update

第一条命令只更新 LTS；第二条更新所有已跟踪通道，并跳过 cjv 本体的更新检查。

uninstall

cjv uninstall <toolchain>... [-y]

uninstall 同时清理 SDK、组件、文档及相关目录覆盖。移除默认工具链时尝试选择其他已装宿主。交互终端会确认，-y/--yes、非交互或 JSON 模式直接执行。toolchain uninstall 是等价入口。

check

cjv check

check 只查询 SDK 和 cjv 的可用更新。开发构建跳过自身版本比较。

查询工具链

toolchain list-remote

cjv toolchain list-remote [--channel all|lts|sts|nightly] [-t suffix] [--all-platforms] [--limit N]

远程列表默认查询所有通道和当前主机平台。--all-platforms 按所有平台分组；--limit 0 不限制每组版本数。-t/--target 过滤交叉目标后缀。

运行命令与配置环境

run

cjv run [--install] <toolchain> <command> [args...]

使用明确指定的工具链运行命令。cjv 先查找 SDK 工具，再查找该环境的 PATH。需要安装缺失工具链时，把 --install 放在工具链参数前：

cjv run --install sts cjc --version

exec

cjv exec [+toolchain] <command> [args...]

使用当前工具链环境运行命令，也可以用 +name 指定工具链。编译产物需要仓颉运行时库时，可以这样运行：

cjv exec ./my_binary
cjv exec +nightly ./my_binary

命令名以 + 开头时，使用 cjv exec -- +command。run 和 exec 都会原样传递子进程参数，并保留退出码。

envsetup

cjv envsetup [+toolchain] [--target=SUFFIX] [--shell=TYPE]

输出配置当前 shell 的脚本，支持 bash、fish、powershell 和 cmd。--target 要求交叉 SDK 已安装；JSON 模式返回环境数据。

输出需要在当前 shell 中执行后才会生效。各 shell 的写法和恢复项目工具链选择的方式见运行环境。

自定义工具链

cjv toolchain link <name> <path|url> [--sha256 <hash>] [--force] [--no-stdx]

目录参数创建链接；归档或 URL 解包为受管安装。三个标志仅适用于归档来源：校验 SHA-256、替换同名安装、跳过随包 stdx。布局和平台限制见自定义 SDK。

交叉编译目标

cjv target list [--toolchain <tc>] [--installed]
cjv target add <suffix>... [--toolchain <tc>]
cjv target remove <suffix>... [--toolchain <tc>]

target add 保留宿主版本；target remove 保留宿主安装。target list --installed 可离线查询。

组件

cjv component add <name>... [--toolchain <tc>] [--target <suffix>] [--force]
cjv component link <name> <path> [--toolchain <tc>] [--target <suffix>] [--force]
cjv component remove <name>... [--toolchain <tc>] [--target <suffix>]
cjv component list [--toolchain <tc>] [--target <suffix>] [--installed] [-q]

组件的 --target 只选择已有交叉 SDK，不安装 SDK。

组件名支持 stdx、docs、stdx-docs，可逗号分隔。component add --force 重新安装组件，component link --force 替换已有组件。只有 stdx 支持本地链接，源目录需包含 dynamic/ 和 static/。外部 SDK 目录链接不支持组件修改。详情见组件。

离线文档

cjv doc [topic] [--path] [--toolchain <tc>]

主题为 std、dev-guide（别名 book）、tools、stdx。省略时打开文档首页。--path 和 --json 只返回路径，其他情况启动浏览器。docs 是命令别名，需要先安装文档组件。

选择与设置

default

cjv default [toolchain]

default 省略参数时显示默认选择，none 清除选择；指定未安装的官方工具链时先安装，失败则保留原选择。交叉 SDK 不能设为默认。

override

cjv override set <toolchain> [--path <dir>]
cjv override unset [--path <dir>] [--nonexistent]
cjv override list

目录覆盖默认作用于当前目录，--nonexistent 清理已不存在目录。设置写入 ~/.cjv/settings.toml，不随 CJV_HOME 改变。字段含义见配置。

set

cjv set auto-self-update <enable|disable|check>
cjv set auto-install <true|false>
cjv set default-host <goos-goarch>
cjv set home <path>

修改用户设置，写入 ~/.cjv/settings.toml。默认值、继承规则和环境变量覆盖见配置。

初始化与自管理

init

cjv init [-y] [--default-toolchain <name>] [-c component]... [--no-modify-path]

init 安装 cjv 命令入口并配置 PATH。它会查询当前平台的可用通道，按 lts、sts、nightly 的顺序选择。交互菜单只列出可用通道；无法确认任何可用通道时，初始化会报错退出。

非终端输入采用非交互模式。工具链安装失败时，命令返回非零退出码，已安装的 cjv 会保留。错误信息提供保留组件选项的重试命令和查询兼容版本的命令。两者都使用已安装程序的绝对路径，无需先刷新 PATH。

self update / self uninstall

cjv self update
cjv self uninstall [-y]

self update 更新 cjv 本体。self uninstall 删除整个数据目录、工具链及组件，并清理 PATH；JSON 模式必须加 -y。

Shell 补全

cjv completion <bash|zsh|fish|powershell>

输出对应 shell 的补全脚本，加载方法见 cjv completion <shell> --help。