版本号从哪来

# 版本号从哪来

一个库要能跑在多个版本的解释器上，就得回答一个问题：**当前这个解释器，够不够新**。Fun 过去的答案不太好用：版本号是 `_time` 里写死的一个字面量，而 `'host'.arg()` 只吐出一行可读串 `fun 9.0`。脚本要么去正则匹配那个字符串，要么干脆假设它一直没变。昨天上游把这件事收成了一条线。

## 一、两条路径，同一个常量

版本事实搬进了一个生成式 include `src/core/version.inc`，`fun.pas` 用 `{$I}` 引入：

```
funVersion = 20260926;   // 数值构建戳，YYYYMMDD
funRelease = '9.0';      // 可读发布串，与 README 的 Version 行一致
```

脚本有两条路径读到它，而且读的是同一个常量，不会各说各话：

```fun
?. 2010.time();                             // 20260926
?. 'host'.arg().getJson(fd:true).version;   // 20260926
?. 2010.time() = 'host'.arg().getJson(fd:true).version;   // True
```

`N.time()` 里 N 落在 2010..2099 时返回 `funVersion`，别的时候它还是时间：0 是当前时间戳，-1/-2 是性能计数器。于是「版本够不够」可以写成一句阈值判断，`lib-ajax` 里就是这么用的：

```fun
if charset = nil and 2010.time() >= 20250819 then
  // 从这一版起才有某能力，走新分支
```

`lib-host-test.fun` 里补了一条回归，断言上面两条路径确实相等；同一条测试还顺手钉住了戳的形状：八位、落在 `20100000..21000000` 之间。

## 二、生成器：先 shell，后 Fun

`version.inc` 不手改，由脚本生成。第一版是 `gen-version.sh`，取 HEAD 的提交日期：改一次提交，戳前进一次，而同一个提交无论哪天重建都是同一个数 —— 可复现，正是脚本想要的「够不够新」。

第二版把它改写成了纯 Fun 的 `gen-version.fun`：

```bash
fun src/prj/fun/gen-version.fun [YYYYMMDD] ["release"]
```

不依赖 shell、不依赖 git，Windows 与 Linux 是同一条命令。为什么最后放弃了 git 日期？注释写得很直白：**可移植地读 git 的输出需要 shell，而 Windows 上 exec 拿不到 stdout**。于是默认改成运行当天的本地日期，要发版就显式传一个保证可复现的数。

脚本本身很短，几处小地方却都得照顾到：

```fun
var stamp   = 2.arg();    // argv[0] 是解释器、argv[1] 是本脚本，用户参数从 2 起
var release = 3.arg();
if release = '' then release = '9.0'; end if;

// 校验：必须恰好 8 位数字，否则退回今天
// 1.time().format('yyyy-mm-dd') -> 去掉所有非数字字符

// 定位输出：从本脚本路径往回找目录，同时认 '/' 和字节 92('\')
while i >= 0 and me[i] <> '/' and me[i] <> 92.toChar() do i -= 1; end do;
var inc = dir & '../../../src/core/version.inc';
inc.save(content);
```

普通构建不跑它：编出来读到的是仓库里那份 `version.inc`，重新生成是发版时的一个显式动作（`make-linux-x86_64.sh` 里只有设了 `FUN_GEN_VERSION=1` 才先运行生成器，而且得有一个已经编好的 `funcmd` 才跑得起来）。顺带，`funcmd.dpr` 启动横幅里写死的 `Fun 9.0` 也换成了拼 `funRelease`。

## 三、余一笔：漏掉的分号

同一天上游还修了一个很容易踩的坑。Fun 的脚本，最后一条语句如果漏写结尾的 `;`，以前会被**静默丢掉**：词法层到了输入结尾不产生任何 token，解析器那句 `if yyretval = 0 then goto done` 提前短路，待归约的语句永远等不到归约。于是一个末行是 `?. x` 的程序以 0 退出，什么都不打印 —— 最容易让人怀疑人生的那种失败。

现在输入结尾被当作一个隐式的语句终结符，最后一行不写 `;` 也会执行。改动只在手写的词法运行时（`src/parse/lib/lexlib.pas` 的 `yydefault()`），不碰任何生成的解析表；而且只作用于输入结尾，语句之间漏写 `;` 仍然是语法错误。

## 结语

版本号原本是解释器对自己的一点记忆，写死在某处，只有人能看懂。现在它有了单一来源，脚本也能读到；连负责生成它的那个脚本，也已经由 Fun 自己来写。让解释器认识自己，是自举路上很小、但很实在的一步。