# Vim 是一门描述文本变换的语言

> source: 想法/草稿/Vim是一门描述文本变换的语言.md

## 问题

> 我是一个懂Vim的基础操作的用户，随着我了解到一些关于Vim的设计哲学，我发现自己过去完全不懂这款编辑器的精妙之处。我认为，在计算机发展几十年以后，它仍然具有非常新颖的设计理念，这些都是现代编辑器没有的。

> 但是我希望了解更多。现在我知道，这个编辑器实际上可以通过很多类似函数式的语句，实现快速以及大批量编辑。但是我已经不知道怎么做了。

## 那段解读的骨架（压缩过）

把 Vim 分成三个理解层次：

1. **操作层**：`hjkl` `dd` `yy` `p` `i` `a`，会移动、会改。
2. **语言层**：操作符 × 移动/文本对象 × 次数，像组织句子一样组织编辑。
   - `di(` = `d`（做什么）+ `i`（内部）+ `(`（对象）。`d` 不管删什么，`i(` 不管被拿来做什么，所以能自由组合：`ci( yi( vi( da(`。
   - 移动命令有双重身份：`w e $ } f, t,` 单独用是移动，接在操作符后面是范围。`d/foo` 让搜索也成了范围。
   - 从「坐标驱动」变成「结构驱动」：`ci(` 不需要知道括号从第几列开始。
   - `.` 重放上一次修改；`n.` 构成「定位 → 修改 → 重复」的循环。
3. **程序层**：编辑行为变成可复用的程序。
   - Ex：`:[range]command`，范围和命令分开（`. $ % 1,10 '<,'>`）。
   - `:g/pat/cmd` ≈ forEach(filter(lines, pat), cmd)；`:v` 取反；`:g/^TODO:/normal! I//` 把普通模式的语言批量用到一组行上。
   - 宏存在寄存器里，是可以查看、修改、传递的数据（`:reg`、`:let @a = …`）。
   - `\=` 表达式替换：`:%s/\d\+/\=submatch(0)*2/g`，替换成为 f(匹配)。

一句话：遇到一百处相似的修改，第一反应不再是「怎么最快逐一改完」，而是「它们能不能被同一条规则描述」。

建议读的帮助：`:help usr_04` `usr_10` `usr_26` `:global` `:normal` `sub-replace-expression`。

## 和仓库里已有的东西的关系

- `文章/vim/index.md`（2026-03-14）是作者的原文，覆盖了操作层和语言层的一半：`dw diw yiw ciw ci" ci(`、`%s`、`:reg`、`@` 宏都提到了，但宏和 `:reg` 只有一句话，`:g` `:normal` `.` `\=` 没有出现。
- 网站已有活文章 `site/live/vim.json` + `site/src/live/vim.ts`：一个只支持 13 条命令的小解释器（`w b 0 $ dw diw ciw yiw ci" ci( i A Esc`），三级缩放的要点全是原文里那几句。

## 方案：怎么组织进网站

**原则：网站只放作者自己的话；AI 这段解读是地图，不是内容。** 所以分三处放：

1. **这份草稿**（现在）：解读的骨架 + 作者的问题，留在 `想法/` 里，不公开。
2. **作者自己的练习记录 → 文章**（之后）：按三层去练，用自己的话写下每层「哪一刻想通了」和真实用过的例子（比如真的拿 `:g` 清过一份日志）。可以是新文章 `文章/vim-language/`，也可以是原文末尾续写一节。活文章的要点只能取作者原话，所以**程序层能不能上网站，取决于作者有没有写下它**。
3. **活文章 `vim` 升级成「语法」版**（文章写好之后）：
   - 引擎从 13 条硬编码命令改成真的语法：操作符（`d c y v`）× 目标（motion：`w e b $ 0 } f{c} t{c} /pat`；文本对象：`iw aw i" a" i( a( ip ap`）× 次数，加上 `.` 和 `n`。再加一个 Ex 小子集：`:s` `:g` `:v` `:normal`、`\=` 只支持 `submatch(0)` 的整数运算。
   - 演示区做成一张**组合表**：行是操作符，列是目标，每一格点下去就在同一段样本文本上真的执行一次——这张表本身就把「可组合」讲清楚了，比逐条列命令有说服力。
   - 第 1 级循环播放 `/legacy` → `ciwmodern` → `n.` → `n.`；第 2 级是组合表；第 3 级是程序层：日志样本上跑 `:g/^DEBUG:/d`、`:v/ERROR/d`、`:g/^ERROR/normal! I!! `，读者可以自己改命令。
   - **核对**：网站的规矩是演示必须真的执行、并和独立基准比对。这里的基准就是真的 Vim：写一个脚本用 `nvim --headless -es` 把每条用例跑一遍，结果存成 `site/live/vim.cases.json` 快照提交进仓库；构建时用快照比对引擎输出（树莓派上不用装 nvim）。不支持的命令要明说「不支持」，不能静默算错。
   - 终端里 `vim` / `编辑器` 命令打开它，和别的活文章一样。

不推荐的放法：

- 放进 `知识库/`：知识库的条目是「陈述 + 证法 + 数值核对」，适合数学结论；Vim 命令不是结论，硬套会很别扭。
- 把 AI 那段原样放进 `/ideas`：网站不展示和 AI 的对话，而且那段内容网上到处都有，放上去没有作者自己的东西。

## 写成了文章（2026-11-05）

> 要围绕Vim设计哲学写一篇文章……要求文章中有足够多的可交互内容，节奏比较好，让读者不至于一头雾水，并及时给出能够加深印象的互动。

成稿在 `文章/vim-language/index.md`（已公开）。作者自己 2026-03 写的 `文章/vim` 没动，它仍然不公开。

- 结构：模式 → 移动 → 动词加名词 → 文本对象 → `.` → 组合成程序（宏、`:g`、`:normal`、`\=`）→ 设计哲学 → 和现代编辑器的差别。每一节都有一个能按的框，最后一道综合题没有唯一答案。
- 框是真的 Vim：`site/src/lib/vim-engine.ts`。做法是**拿 Neovim 当标准答案**：`site/scripts/vim-cases.mjs` 把每条用例和文章里每个框的参考答案用 `nvim --headless -s` 敲一遍，记下结果；测试要求引擎和它逐字一致（第一次跑 248 条里错 39 条，大多是同一个 bug：进入插入模式时没清掉待定的按键）。
- 写文章的规矩在这次改了：AI 写的直接进 `文章/`，网站上不再标谁写的。
- nvim 的 `-s` 脚本输入不会在两个 `x` 之间切开撤销块，所以 `xxu` 在脚本里会一次撤掉两个；这类用例没放进对照集。

## 还没想通的

- 程序层的东西（`:g`、宏、表达式替换）作者自己还没练过。先练、再写、再做演示，还是先做一个练习场帮自己练？
- 组合表的样本文本用什么？一段代码（括号、引号多，适合文本对象）和一段日志（行多，适合 `:g`）可能要两段。
- 浏览器里的键盘事件和网站终端的快捷键（`/` 聚焦、`q`、数字切级）会冲突，演示区获得焦点时要把键盘整个交给它，怎么退出要设计。
