命令行参考
cn 编译器的全部子命令、选项与调试手段——单命令工具链。
七个子命令
| 命令 | 作用 | 产物 |
|---|---|---|
cn build 文.cn | 编译并链接 | 可执行文件(--output 可改名) |
cn run 文.cn | 编译+运行一步到位 | (临时产物) |
cn compile 文.cn | 仅编译到汇编 | .asm(win)/ .s(linux) |
cn check 文.cn | 仅语法+类型检查 | 无(秒级反馈) |
cn ir 文.cn | 输出中间表示 | IR 文本(调试用) |
cn ast 文.cn | 输出语法树 | AST 文本(调试用) |
cn token 文.cn | 输出词元流 | Token 列表(调试用) |
全部选项
| 选项 | 作用 |
|---|---|
--target <平台> | 目标平台:win-x64 | linux-x86_64 | linux-arm64 |
-O0 ~ -O3 / --opt <级> | 优化级别(见下表) |
--output <路径> | 输出文件路径 |
--发布 / --release | 发布构建:内建常量 调试模式=假 |
--debug | 汇编中嵌入源码位置注释 |
--no-regalloc | 关闭寄存器分配(保持全栈帧·阶段C 调试用) |
--verbose | 详细输出 |
--stdlib <路径> | 指定内置 stdlib 目录(默认相对可执行文件探测) |
--货舱 <路径> | 指定 货舱.toml(默认入口同目录自动发现) |
-D <宏名> | 编译期注入条件编译宏(可多次;等价源内 #定义)——见词法结构·条件编译 |
--链接 <库> | 附加链接库(FFI;可多次;别名 --link-lib) |
--version / -v · --help / -h | 版本与帮助 |
优化级别
| 级别 | 内容 |
|---|---|
-O0 | 无优化(默认) |
-O1 | 常量折叠+死代码消除+代数简化+复写传播 |
-O2 | + 公共子表达式消除+跨块死代码消除+寄存器分配 |
-O3 | + 全局值传播 |
运行时环境变量与诊断通道
| 变量/通道 | 作用 |
|---|---|
CN_RT_MEM_STATS=1 | 进程退出时 stderr 打印 8 档分配直方图(内存观测·默认关闭) |
运行时错误(错误码N): 消息 | stdout·运行时错误诊断行,打印后终止(退出码 1) |
运行时错误(错误码9): 栈溢出 | stdout·栈溢出确定性失败:深度递归耗尽线程栈 → 进程级信号兜底捕获(linux=SIGSEGV+备用栈 / win=EXCEPTION_STACK_OVERFLOW),打印后终止(退出码 1)——安全区与 不安全 函数内同样生效(面向整个进程) |
[cnrt] cn_realloc 拒绝异常尺寸 N | stderr·重新分配 >2GiB 拒绝(返回 无 不终止) |
cn_install_thread_stack_guard() | 运行时公开 API(FFI 可声明):为当前线程安装栈溢出备用栈——手工 pthread_create 线程须在线程入口调用一次(经 线程::新 创建=运行时自动装);win=空操作(进程级过滤器覆盖全部线程) |
[crash]/[veh] 系列 | stderr·仅未处理异常时输出(寄存器+回溯 RVA);正常启动零输出 |
- E2E 只比对 stdout——诊断走 stderr 不进比对面,但都是用户可观察行为契约。
- 栈溢出防线的性质=进程级信号兜底(运行时入口一次性安装),零热路径开销——函数体内不插任何栈检查代码;判据是指纹匹配(故障地址与栈指针比邻),匹配不到=不拦截(恢复平台默认崩溃,不误报、不承诺)。E2E 锚:
735_栈溢出确定性失败(深递归→错误码 9·rc=1 +健康深度对照)、821_手工线程栈守卫(手工线程显式安装后同款)。 - 交叉编译示例:
cn build 主.cn --target linux-arm64 -O2(在本机产出 ARM64 汇编,链接与运行在对应目标机)。
手工线程栈守卫.cnCN
外部 函数 cn_install_thread_stack_guard() -> 空类型
外部 函数 pthread_create(整64* 线程号, 空类型* 属性, 空类型(*入口)(空类型*), 空类型* 参数) -> 整32
外部 函数 pthread_join(整64 线程号, 空类型** 返回值) -> 整32
函数 递(整64 深度) -> 整64 {
如果 (深度 <= 0) {
返回 0;
}
返回 深度 + 递(深度 - 1); // 非尾递归(结果参与相加·不受尾调用优化)
}
不安全 函数 手工线程体(空类型* 参数) -> 空类型 {
cn_install_thread_stack_guard(); // 728k:手工线程入口显式安装(本次验证点)
打印(递(1000)); // 500500 安全深度(健康对照·防误伤)
打印(递(100000000)); // 深递归 → 运行时错误(错误码9): 栈溢出 终止
返回;
}
不安全 函数 主() -> 整32 {
打印("===== 929 手工线程栈守卫 =====");
整64 线程号 = 0;
整32 创建 = pthread_create(&线程号, 无, 手工线程体, 无);
如果 (创建 != 0) { // 创建失败=环境不支持(如实报出·不静默)
打印("pthread_create 失败:", 创建);
返回 2;
}
pthread_join(线程号, 无);
返回 0;
}输出:===== 929 手工线程栈守卫 ===== 500500 运行时错误(错误码9): 栈溢出