快速上手

本章带你跑通从安装工具链到运行仓颉工具的完整流程，并介绍日常会用到的常用命令。读完即可上手，更深入的概念见核心概念，每条命令的完整选项见命令参考。

本章假设你已经装好了 cjv 本身。如果还没有，先看安装 cjv。

五分钟跑通

下面四步演示了最典型的用法：安装一个 LTS 工具链、把它设为默认、检查状态，再用它运行命令。

# 1. 安装最新的 LTS 工具链
cjv install lts

# 2. 设为默认工具链
cjv default lts

# 3. 查看活跃和已安装的工具链
cjv show

# 4. 用指定工具链运行命令
cjv run lts cjc --version

cjv install lts 下载并安装 LTS 通道的最新工具链。lts 是一个通道名，cjv 会把它解析成具体版本。除了 lts，你还可以安装 sts、nightly 或某个确切的版本号。各通道的含义见通道。

cjv default lts 把 lts 记为默认工具链。设好默认后，未在项目里另行声明工具链时，cjv 都会使用它。

cjv show 列出当前活跃的工具链和所有已安装的工具链，便于确认安装结果。只想看其中一项时，可用 cjv show active 或 cjv show installed。

cjv run lts cjc --version 显式用 lts 工具链执行 cjc --version。cjv run <工具链> <命令> [参数...] 临时切到指定工具链运行某条命令，不改变默认设置，便于在多个工具链之间临时对比。

装好工具链并配置好 PATH 后，你不需要每条命令都加 cjv run 前缀，直接调用 SDK 工具即可：

cjc --version
cjpm build

cjv 会解析当前应使用的工具链，把命令转发给对应的 SDK，并配置必要的运行环境。常用的 cjc、cjpm、cjfmt、cjlint、cjdb、cjcov、cjprof 等工具都支持这种用法。

代理使用的工具链解析规则与 cjv run 一致，但不需要你指定工具链。它会按优先级自动判断：环境变量、目录覆盖、项目中的 cangjie-sdk.toml，最后回退到默认工具链。完整的解析顺序见代理与目标与覆盖。

如果解析到的工具链尚未安装，且你启用了 auto_install 设置，cjv 会在代理前自动把它装上，无需手动 cjv install。开启方式：

cjv set auto-install true

该设置的细节见配置。

提示：仓颉编译出的二进制文件在运行时还需要正确的库搜索路径。运行自己编译出的程序见运行时环境中的 cjv exec 与 cjv envsetup。

把工具链声明写进项目，团队成员进入该目录后就会自动用上同一个工具链，无需各自手动切换。在项目根目录放一个 cangjie-sdk.toml：

[toolchain]
channel = "lts"

之后在该目录（或其子目录）里，无论是 cjv run、代理执行的 cjc/cjpm，还是 cjv show active，都会优先使用这里声明的工具链。该文件的完整字段（channel、components、targets）见工具链文件。

如果只想给某个目录临时绑定一个工具链而不提交文件，可以用目录覆盖：

cjv override set nightly

下面是日常最常用的命令。每条命令的完整参数和子命令见命令参考。