`import json:lib/json.mq.md` binds file libraries; `import fmt:time.format` binds member short names (replaces `> use`). Legacy `> path.mq.md` / `> use` now hard-error with a hint. Migrates repo docs, skills, ext, lib, public, examples, man-test and tests; adds a negative gold and updates view/catalog rendering. Co-authored-by: Cursor <cursoragent@cursor.com>
5.4 KiB
5.4 KiB
内置关键字 / 函数:中英双名(草案)
| 状态 | 已定(已实现) |
| 日期 | 2026-08-05 |
| 原则 | 无需导入;中英为同一语义的别名,不是语言模式开关 |
| 相关 | keywords.md · stdlib-i18n.md · call-arguments.md |
1. 动机
Marqdo 要中英文都能自然书写。标准库已约定「库文件名区分语言」(见 stdlib-i18n.md);对不必导入的一层——字面量关键字与极少内置函数——也要对等提供中文名。
正因为每增加一个内置名,就要同时维护中英(及日后更多语言)别名,所以:
关键字 / 内置必须少而精——体积在「名字 × 语言」上放大,而不是在功能清单上堆满。
更多能力进可导入的 lib/,用中英不同库文件、不同函数名扩展,不膨胀解释器内核。
2. 分层(与标准库对齐)
| 层 | 是否导入 | 中英怎么区分 |
|---|---|---|
| L0 内核 | 否 | 同一文件内双名:print ≡ 打印;True ≡ 真 |
| L1 标准库 | 是(import …:lib/…) |
不同文件:text.mq.md vs 文本.mq.md(见 i18n 草案) |
L0 不做 lang:、不做「当前语言模式」;写英文名就用英文,写中文名就用中文,可在同一程序里混用。
3. 范围:哪些要双名
3.1 字面量 / 逻辑关键字(词法保留)
控制流仍靠 Markdown(# 1. - * **),不为 if/while/def 做中英关键字。形参用 +。
| 英文 | 中文(提案) | 备注 |
|---|---|---|
True |
真 |
布尔真 |
False |
假 |
布尔假 |
None |
空 |
空值 |
and |
且 |
逻辑与 |
or |
或 |
逻辑或 |
not |
非 |
逻辑非 |
中英文名均不可作变量名(同一保留集)。
3.2 内置函数(可调用、无需导入)
仅下列核心五项做中英双名(与「少而精」一致):
| 英文 | 中文(提案) | 作用 |
|---|---|---|
print |
打印 |
写 stdout |
input |
输入 |
读一行 |
len |
长度 |
文本/表长度 |
str |
文本 |
转为显示文本 |
int |
整数 |
转为整数 |
形参名也提供中英别名(便于纯中文调用):
| 英文形参 | 中文形参 | 用于 |
|---|---|---|
text |
内容 |
print / 打印 |
prompt |
提示 |
input / 输入 |
value |
值 |
len/str/int 及对应中文名 |
示例(等价):
> print text=Hello
> 打印 内容=你好
*`n` = > len `s`*
*`n` = > 长度 值=`s`*
3.3 明确不进 L0 双名表
下列若已在解释器中实现,视为宿主原语 / 过渡 API,不再批中文内核别名;应迁入或仅通过标准库暴露(中英分文件):
| 英文名 | 去向 |
|---|---|
type |
L1 或维持实现细节,不进「关键字最少集」宣传 |
trim split join |
L1:lib/text.mq.md / lib/文本.mq.md |
at |
L1:lib/table.mq.md / lib/表.mq.md |
这样 L0 公开面 ≈ 6 个关键字词 ×2 + 5 个函数 ×2,而不是「每个工具函数都 ×2」。
4. 语义规则
- 别名等价:中英文名绑定同一实现;诊断文案可用英文稳定串(金样例已有),用户文档中英均可举例。
- 可混用:同一文件可同时出现
print与打印、True与真。 - 遮蔽:用户
# 打印与# print均会遮蔽对应内置名(实现阶段应警告)。 - 大小写:英文关键字保持 Python 风格(
True/False/None);中文无名感大小写问题。 - 扩语言:日后日文等 → 再为 L0 增加第三个别名列;仍无「名字表」而非语言开关。标准库继续用文件名区分(见 i18n 草案)。
5. 与旧决议的关系
- 旧文「中文
print废弃、统一为print」:废止;改为正式双名print/打印。 - keywords.md 原则条「英文标识」改为「内核双名;标准库分文件」——实现阶段改正文。
- 不引入中文控制流关键字(
如果/循环等);分支用1.…,循环用-。
6. 文档与金样例义务(实现时)
| 项 | 要求 |
|---|---|
keywords.md |
L0 表改为中英并列;砍掉对 trim/split/… 的「内核关键字」宣传 |
public/ |
英 / 中文件同目录并列(拉丁名 vs 中文名) |
tests/ |
中文关键字 / 打印·长度 等金样例;与英文样例对等 |
| 诊断 | 位置格式不变;message 可暂维持英文,或中英均可接受(另开小节) |
7. 实现备忘(暂不开发)
- 词法 / 解析:字面量与
and/or/not识别中文别名。 - 调用解析:内置表按别名归一到同一
BuiltinId。 - 形参绑定:
text≡内容,prompt≡提示,value≡值。 - 不要加
lang:或全局「中文模式」。 - 与 stdlib-i18n.md 一并落地时:先收束 L0 公开面,再铺
lib/text↔lib/文本。
8. 一句话
内核:中英别名、无需导入、必须少;标准库:中英分文件、靠导入路径选择——这样 Marqdo 才能中英文通用而不把解释器撑爆。