仓颉语言编译与构建 Skill
- cjc 编译器
1.1 基本用法
-
cjc 是仓颉编译器
-
用法：cjc [option] file...
-
编译为可执行文件，默认名称为 main
-
示例：cjc hello.cj
1.2 前端与后端
-
cjc-frontend 是仅前端编译器（输出 LLVM IR）
-
cjc 自动处理前端 + 后端 + 链接
1.3 主要选项
-
-o 指定输出文件名
-
--output-type 指定输出类型（如 dylib ）
-
--compile-macro 编译宏包
-
--import-path 指定导入路径
-
-L /-l 链接库路径和库名
-
--cfg 定义条件编译变量
-
-g 启用调试信息
-
--test 启用测试模式
-
--debug-macro 启用宏调试
如需了解 cjc 更多细节，请引用 cangjie-cjc Skill
- cjpm 项目管理器
2.1 功能
- 管理仓颉项目：模块系统、依赖解析（多版本冲突解决）、自定义构建脚本
2.2 主要命令
命令 说明
init
创建项目（生成 cjpm.toml
- src/main.cj ）
build
编译（支持增量/并行/交叉编译，-V 详细输出）
run
运行
test
测试
bench
基准测试
clean
清理
install
安装
uninstall
卸载
check
检查
update
更新依赖
tree
显示依赖树
2.3 cjpm.toml 配置
[package] 区段
-
name — 包名
-
version — 版本
-
cjc-version — 编译器版本
-
output-type — 输出类型
-
compile-option — 编译选项
-
src-dir — 源码目录
-
target-dir — 目标目录
[workspace] 区段
-
members — 工作区成员
-
build-members — 构建成员
-
test-members — 测试成员
其他区段
-
[dependencies] — 依赖（git/path 来源）
-
[test-dependencies] — 测试依赖
-
[ffi.c] — C 库依赖
-
[profile] — 构建/测试/基准配置
-
[target.<triple>] — 平台特定设置
如需了解仓颉项目的组织构建和 cjpm 更多细节，请引用 cangjie-project-management Skill
- 条件编译
3.1 语法
-
使用 @When[condition] 应用于导入/声明节点（非 package ）
-
不允许嵌套
-
不能出现在宏生成的代码中
3.2 内置变量
变量 操作 值
os
== /!=
"Windows" 、"Linux" 、"macOS"
backend
== /!=
"cjnative"
arch
== /!=
"x86_64" 、"aarch64"
cjc_version
全部 6 种比较 格式 xx.xx.xx
debug
! 仅 -g 启用时为 true
test
! 仅 --test 使用时为 true
3.3 自定义变量
-
通过 --cfg "key=value" 或 cfg.toml 文件定义
-
支持 == /!=
-
不能与内置变量名重复
-
多个条件可用 && 、|| 、! 、() 组合