laomeng-zhc-tutorial
老孟带你学编程系列教程技能。当用户想学中文编程、要从零入门、要按课次系统练习,或需要讲解 ZHC 语法(输出/变量/条件/循环/函数/文本与列表/表格统计)并配可运行示例时使用本技能。适用于零基础入门教学、按课次陪练、语法点讲解、练习题设计与批改场景。7 课示例均在当前内核实测 rc=0。
老孟带你学编程(ZHC 入门教程)
1.0.15(2026-11-16) 口径追平
ZHC-LANG-2.1冻结层:生态于 2026-11-16 09:54:16 新开ZHC-LANG-2.1层,当前内核(190000 B /92806D53…)与契约(56880 B /9C164AA6…,内部修订 2.6)已成正式基线,C04 由红转绿。7 课讲解与 7 份示例逐字未改,在内核上复跑仍 7/7rc=0。本版统一版本序列:四包 × 两渠道同号 1.0.15。
1.0.13(2026-11-16) 渠道授权口径分叉:本包经 ClawHub 渠道发布,依平台统一规则以 MIT-0 授权。
license字段与LICENSE.txt改为「MIT-0 授权 + 归属声明(事实记载)」,移除原条款中的署名、改名与限售限制;内核、契约、脚本与示例零改动,功能与用法与前版完全一致。 1.0.12(2026-11-15) 首次随生态发版。与laomeng-zhc、laomeng-zhc-agent同版本号、同口径:ZHC-LANG 2.0/ 契约族 1.8 / 内部修订 2.6 / 唯一码位 39 / 关键字 44 · 保留词 72 · 内置 39 · 类型 11。
一套从零到能写小工具的中文编程教程。7 课、7 份讲解文档、7 个可编译运行的 .zc 示例,全部在当前内核实测通过(rc=0),代码与运行结果一一对应。
本包只含教程与示例源码,不含语言内核。 要真正编译运行,需同时安装
laomeng-zhc(含内核zhc.py)。查契约与错误码口径用laomeng-zhc-kb。
何时使用
- 用户说"学中文编程""带我学""老孟带你学编程""从零入门 ZHC"。
- 用户要按课次系统练:第几课、下一课、给我练习。
- 用户问某个基础语法怎么写,且属于这 7 课覆盖范围。
- 用户写得不对,需要按课次知识点指出错在哪并给出正确写法。
不适用:查契约字段/错误码出处 → laomeng-zhc-kb;真实编译排障(环境、目标、桥)→ laomeng-zhc。
一、课表(教学主线,顺序不可乱)
| 课次 | 主题 | 讲解文档 | 示例源码 | 学到什么 |
|---|---|---|---|---|
| 第01课 | 你好,中文编程 | lessons/第01课_你好中文编程.md | samples/第01课_你好中文编程.zc | 输出、注释、字符串转义,跑通第一条链路 |
| 第02课 | 变量与类型 | lessons/第02课_变量与类型.md | samples/第02课_变量与类型.zc | 定义/设、整数浮点文本逻辑、四则运算 |
| 第03课 | 条件判断 | lessons/第03课_条件判断.md | samples/第03课_条件判断.zc | 如果/否则如果/否则/结束、且或非 |
| 第04课 | 循环 | lessons/第04课_循环.md | samples/第04课_循环.zc | 计数循环、前测循环、无 break 的退出设计 |
| 第05课 | 函数 | lessons/第05课_函数.md | samples/第05课_函数.zc | 带/不带返回值、多参数、递归 |
| 第06课 | 文本与列表 | lessons/第06课_文本与列表.md | samples/第06课_文本与列表.zc | 连接/长度/比较、列表增改查与遍历 |
| 第07课 | 综合练习:成绩统计 | lessons/第07课_综合练习_成绩统计.md | samples/第07课_综合练习_成绩统计.zc | 表与记录、遍历聚合、转 JSON |
教学前必读 lessons/README.md(导引、运行方式、后续课程规划)。
二、每课固定讲法(七步,不要省)
- 说目标:这一课学完能写出什么。
- 给语法表:本课新语法的中文关键字 + 形态 + 一句作用说明。
- 贴完整代码:给可整段复制运行的
.zc,不要给片段。 - 给实测输出:贴真实运行结果,让学员能自我对照。
- 点易错处:把本课最容易写错的两三处单独列,附正确写法。
- 布置练习:一到两题,基于本课语法,不引入未学内容。
- 接下一课:一句话说明下一步会解决本课遗留的限制。
三、运行方式(学员机上)
cd <工程根目录>
$env:PYTHONIOENCODING='utf-8'
# 编译并立即运行
python -X utf8 zhc.py samples\第01课_你好中文编程.zc --run
# 只做词法语法检查(输出 JSON 诊断)
python -X utf8 zhc.py samples\第01课_你好中文编程.zc --诊断
# 查内置函数手册与全部关键字
python -X utf8 zhc.py --api
报错一律形如 [Exxx] 中文说明,拿码位去 laomeng-zhc-kb 的错误码表查成因与修法。
四、必须提前告知学员的三条限制
这三条是实测踩出来的,不是猜测,讲课时先讲清楚可省大量返工:
- 类型词只能写在变量名后面:写
定义 总分 为 整数 600;写定义 整数 总分 为 600会报[E012](类型词不能前置)。 - 逻辑量要写全类型:
定义 没缺考 为 逻辑 真;只写为 真报[E205],报错会直接给出正确写法。 - 无返回值函数只能单独成句:写进
输出参数或表达式里报[E307]。
早期"紧跟带函数调用的输出会报构建期
C2155"的问题已在ZHC-LANG 2.0实现修订中修复,不再作为限制讲授。
五、学完七课的能力边界
能做:读既有 .zc 源码;写计算类、文本处理类、表格统计类小工具;看懂中文报错并定位成因。
还不能做(属进阶课):文件读写、命令行参数、表与 JSON 互转、Office 导出、内存与指针。被问到时如实说明属进阶内容,不要越界硬讲。
六、批改与答疑口径
- 学员代码报错 → 先按
[Exxx]码位定性,再指到对应课次的知识点,最后给最小改正。 - 学员问"为什么不支持某写法" → 区分三种情况:① 契约未定义(改代码);② 预留关键字(如
接受无语法作用,禁止用于函数定义);③ 已知限制(见第四节)。禁止把三者混为一谈。 - 学员问版本 → 一律回答
ZHC-LANG 2.0(契约族 1.8 / 内部修订 2.6),不得引用旧版本号。
- Downloads
- Security audit
- Review
- Last updated
- 2d ago
- Current version
- v1.0.15
- License
- MIT-0
