官方文档
从零基础到系统级开发者的完整学习路径——全部示例经编译器实测。
学习路径:三个阶段
CN 是一门全中文语法的系统级编程语言(C++ 风格),目标是性能对标 C++、安全对标 Rust。按下面的路径学习,每个阶段都有可运行的代码伴随。
| 阶段 | 你将学会 | 文档 |
|---|---|---|
| ① 入门(半天) | 安装工具链、写出并运行第一个程序、掌握变量/控制流/函数/数组/字符串 | 快速开始 → 语法基础 |
| ② 进阶(两三天) | 类与泛型、错误处理、所有权与转移、线程与互斥锁、内存模型与 FFI | 类与泛型 → 安全与并发 → 进阶篇 |
| ③ 资深(随用随查) | 词法/类型/控制流/函数/OOP/错误/并发/模块 全语法细节,标准库全部 API,命令行全参数 | 语言参考九篇 → 标准库 → 命令行参考 |
示例的可信度本站全部 CN 代码示例逐个经过编译器编译+运行+输出比对(与开发者在真实链路上验证同款流程),示例下方标注的「输出」即真实运行结果,非手写。
一分钟看懂 CN 长什么样
一个摸底示例:变量、函数、容器、遍历、结果检查、字符串拼接各一遭。
主.cnCN
函数 主() -> 整32 {
// ---- 1. 三元表达式 ----
整32 x = 10;
打印("三元正: ", x > 0 ? "正" : "负"); // 三元正: 正
打印("三元反: ", x < 0 ? "正" : "负"); // 三元反: 负
打印("三元数: ", x > 5 ? 100 : 200); // 三元数: 100
打印("三元浮: ", x > 5 ? 1.5 : 2.5); // 三元浮: 1.500000
打印("嵌套三元: ", x > 0 ? (x > 5 ? "大" : "小") : "非正"); // 嵌套三元: 大
打印("三元惰性: ", 真 ? 字符串长度("abc") : 字符串长度("abcdefghij")); // 三元惰性: 3
// 嵌套右结合:a ? b : c ? d : e = a ? b : (c ? d : e)
打印("右结合: ", 假 ? "一" : 假 ? "二" : "三"); // 右结合: 三
// ---- 2. 字符串 + 数值 隐式拼接 ----
打印("你好,世界" + 123); // 你好,世界123
打印("结果=" + 3.14); // 结果=3.140000
打印("布尔=" + 真); // 布尔=真
打印("布尔=" + 假); // 布尔=假
打印("字符=" + 'A'); // 字符=A
打印("多操作数: " + 1 + 2); // 多操作数: 12
打印("混合: " + 1 + " + " + 2.5); // 混合: 1 + 2.500000
整64 大数 = 1000000000L;
打印("整64拼接: " + 大数); // 整64拼接: 1000000000
打印("字符串变量拼接: ", "值" + 42); // 字符串变量拼接: 值42
// 拼接产物内存由调用方释放(连接/转换均为动态内存)
字符串 拼接 = "A" + 1 + 2 + 3;
打印("拼接产物: ", 拼接); // 拼接产物: A123
// ---- 3. 格式化() ----
字符串 格1 = 格式化("值%d 浮点%f", 42, 3.14);
打印("格式化1: ", 格1); // 格式化1: 值42 浮点3.140000
字符串 格2 = 格式化("%s 世界", "你好");
打印("格式化2: ", 格2); // 格式化2: 你好 世界
字符串 格3 = 格式化("字符%c 十六%x 大写%X 八%o", 65, 255, 255, 8);
打印("格式化3: ", 格3); // 格式化3: 字符A 十六ff 大写FF 八10
字符串 格4 = 格式化("无符号%u", 4000000000U);
打印("格式化4: ", 格4); // 格式化4: 无符号4000000000
// 注:%p(指针十六进制地址)输出不定,放单元测试(test_format_api.cpp)断言前缀;
// 此处用 %x 覆盖十六进制小写(%X 大写已在 格3 覆盖)
字符串 格5 = 格式化("十六%x", 4096);
打印("格式化5: ", 格5); // 格式化5: 十六1000
// ---- 4. 打印 / 打印行 语义 ----
打印("打印自动换行");
打印("第二行"); // 打印 每次自动换行
打印行("打印行不换行");
打印行("继续同一行"); // 打印行 不换行,两段连在一起
打印("");
打印("分隔完成");
返回 0;
}输出:三元正: 正 三元反: 负 三元数: 100 三元浮: 1.500000 嵌套三元: 大 三元惰性: 3 右结合: 三 你好,世界123 结果=3.140000 布尔=真 布尔=假 字符=A 多操作数: 12 混合: 1 + 2.500000 整64拼接: 1000000000 字符串变量拼接: 值42 拼接产物: A123 格式化1: 值42 浮点3.140000 格式化2: 你好 世界 格式化3: 字符A 十六ff 大写FF 八10 格式化4: 无符号4000000000 格式化5: 十六1000 打印自动换行 第二行 打印行不换行继续同一行 分隔完成
看懂了多少就算多少——接下来每个语法点都会在语法基础里展开。
全站地图
| 分类 | 页面 | 内容 |
|---|---|---|
| 入门 | 快速开始 | 安装、Hello World、编译运行工作流、常见问题 |
| 教程 | 语法基础 | 变量与类型、运算符、控制流、函数、数组与字符串、结构体、枚举 |
| 教程 | 类与泛型 | 类、构造与析构、继承与接口、泛型类与泛型函数、运算符重载 |
| 教程 | 安全与并发 | 结果与可选、所有权与转移、线程、互斥锁、安全区边界 |
| 教程 | 进阶篇 | 内存模型、拥有型字符串、指针与不安全域、FFI、优化与调试、自举 |
| 参考 | 语言参考(九篇) | 词法结构、类型系统、控制流、函数、类与对象、错误处理、并发、模块系统——逐条语法语义 |
| 标准库 | 标准库 | 13 个模块 187 个条目逐函数文档(定义/用法/示例) |
| 工具 | 命令行参考 | cn 全部子命令与选项、优化级别、目标平台、调试手段 |
| 迁移 | 破坏性变更与迁移指南 | 结果化收割(哨兵 → 结果/可选)的变更公告、新旧写法对照表、机械替换禁区——依赖旧哨兵形态的外部代码从这里开始迁移 |
两句话理解语言设计(+ 安全模型四条法令)
- 默认安全:变量必须初始化才能读;
结果<T, E>必须显式检查(丢弃即编译错误);资源随作用域自动释放(RAII);裸指针/手动内存收进不安全域。 - 性能不妥协:零成本抽象(检查全部在编译期)、C 风格内存布局、可下探到汇编级的手动控制(
分配/释放/复制内存)、三后端(win-x64 / linux-x86_64 / linux-arm64)。
安全模型四条法令(分层安全总则)
- ① 编译期能证明的,必须在编译期拦——常量下标越界(
整32[3] 表; 表[5])、常量除零(10 / 0)、常量空指针解引用(B11)等可判定形态一律硬错误,不得静默放行到运行期。 - ② 编译期证不了的,安全区以确定性失败兜底——运行期检查(错误码 + 立即终止,非未定义行为)是安全区的合法防线——错误码 1~9 (含栈溢出),Rust panic 同款语义:可控行为,不是脏崩溃。
- ③ 完备访问通道并行提供——追求编译期完备的场景使用结果化 API(
结果/可选+ 强制检查三分支),用户自选。 - ④
不安全 函数= 真零运行期检查——手动管理区编译器不插检查(溢出检查都豁免:按两补码回绕继续执行);代价是审计责任上移(审计面 = 不安全函数清单)。