快速开始
十分钟:装好工具链,写出、编译、运行你的第一个 CN 程序。
第一步:获取编译器
两条路线:直接拿可执行文件(快),或从源码构建(想参与项目/在 Linux/ARM64 上使用)。
路线 A:源码构建(当前主推)
项目暂未发布安装包,从源码构建只需一步——编译器自身是 C++ 项目,依赖仅有 CMake + 一个 C++17 编译器 +汇编器/链接器:
构建(Windows·MSVC)SHELL
git clone https://gitcode.com/ChenChao_GitCode/CN_Language.git
cd CN_Language
cmake -B build -G "Visual Studio 17 2022"
cmake --build build --config Release
:: 产物:build\Release\cn.exe(或按 CMake 配置命名)构建(Linux / macOS 等价流程)SHELL
git clone https://gitcode.com/ChenChao_GitCode/CN_Language.git
cd CN_Language
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
# 产物:build/cn三平台支持编译器可生成三种目标平台的代码:win-x64(MASM)、linux-x86_64(GAS)、linux-arm64(GAS)——用
--target 选择(详见命令行参考)。编译器本身目前主要在 Windows 与 Linux x86_64 上运行。第二步:Hello World
CN 的源文件以 .cn 为扩展名,UTF-8 编码。程序入口是 主 函数。
主.cnCN
函数 主() -> 整32 {
打印("你好,世界");
返回 0;
}输出:你好,世界
三个要点:①函数 声明函数;②-> 整32 是返回类型(操作系统退出码,0=成功);③打印 是内置变参输出,末尾自动换行,多参数直接逗号排开。另:入口签名恒为无参——主 不带 C 风格 argc/argv 参数,带参形态在链接期被拒;命令行参数用内置 系统::参数个数() / 系统::参数(索引) 拿(argv[0]=可执行文件名,越界返回 无),详见语言参考·源文件。
第三步:编译、运行、检查
cn 是单命令工具链:build 出可执行文件、run 一键编译并运行、check 只做语法与类型检查不生成代码。
工作流SHELL
cn build 你好.cn :: 编译出 你好.exe
你好.exe :: 运行 → 你好,CN!
cn run 你好.cn :: 编译+运行一步到位
cn check 你好.cn :: 只检查错误,不生成代码
cn build 你好.cn -O2 :: 开优化(-O0 ~ -O3)cn build默认输出与源文件同名的可执行文件;用--output 路径改名。cn run适合脚本式迭代——改一行跑一次。cn check秒级反馈,大改动时先 check 再 build 省时间。- 报错都是中文诊断并带行列定位,例如:
你好.cn:5:5: 错误: 未声明的标识符 '打印'。
第四步:稍大一点的程序
一个猜数小游戏,串起输入、循环、条件、类型转换与结果检查——这些都是日常写 CN 的核心动作。
主.cnCN
导入 随机数::随机数生成器;
函数 主() -> 整32 {
随机数生成器 甲 = 随机数生成器(42);
随机数生成器 乙 = 随机数生成器(42);
整64 a1 = 甲.下一个();
整64 b1 = 乙.下一个();
打印(a1 == b1);
整64 c = 甲.下一个范围(100);
打印(c < 100);
打印(乙.下一个范围(50) < 50);
返回 0;
}输出:真 真 真
读取整数()返回结果<整64, 整32>——必须检查(.正常),直接当数值用是编译错误。输入.值只能在「已检查.正常」的分支里访问,编译器帮你把关。随机数生成器(种子)同种子同序列——把种子换成当前时间戳()即可每次不同(见随机数)。
常见问题
| 现象 | 原因与解法 |
|---|---|
错误: 未声明的标识符 'xxx' | 函数/变量名拼错,或忘了 导入 模块::名;。标准库函数(打印/字符串长度 等)是内置的,不需要导入。 |
结果<正常,错误> 返回值被丢弃未检查 | 返回 结果 的调用不能当裸语句——按结果检查纪律接收并检查。 |
[安全区边界] xxx 应在 不安全 函数 内 | 裸指针/手动内存操作须放在 不安全 函数 里,见进阶篇·安全区边界。 |
链接失败(带参的 主) | 入口签名恒为无参——函数 主(整32 个数, 字符** 表) 等 C 风格带参形态不合成入口符号 cn_main,链接期被拒。命令行参数改用 系统::参数个数() / 系统::参数(索引):见语言参考·源文件。 |
| 中文显示乱码(Windows 控制台) | CN 源码与输出均为 UTF-8;老式 cmd 需先 chcp 65001 切到 UTF-8 代码页(Windows Terminal 默认即可)。 |
| 链接阶段报缺 MASM/GAS | win 目标需随 Visual Studio 安装的主题组件(masm);linux 目标需 binutils。交叉目标用 --target 指定。 |
继续:语法基础教程 →