CN·语言

命令行参考

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 拒绝异常尺寸 Nstderr·重新分配 >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): 栈溢出

语言本身的问题去 语言参考;标准库 API 去 标准库。