14｜会话与最终挑战——完整日常开发流程

前面的章节分别练习了不同操作，本章把它们串成一套完整的日常开发流程：

明确进入项目 → 恢复布局 → 找需求位置 → 先写失败测试 → 实现 → 看诊断 → 跑测试 → 审查差异 → 暂存提交 → 保存会话 → 明天回来

最后再单独练习会话恢复。完成本章后，你应当能够使用 Neovim 完成主要开发流程，并在忘记按键时查找对应章节或速查表。

工作流一的新按键：保存和载入布局

按键	效果
`Space` `s` `c`	保存当前工作目录的会话
`Space` `s` `l`	打开会话选择器
`Space` `s` `l` `t`	载入最近会话
`Space` `s` `d`	选择并删除会话记录

Space s l 同时是更长组合的前缀。只按到 l 后停住，选择器可能等大约 500 毫秒才出现；想载入最近会话时，把 t 连着按完。

会话会保存哪些内容

会话主要记录：

当前工作目录；
打开的普通文件 Buffer；
Window 与 Tab 布局；
折叠等编辑现场；
项目再次载入时需要恢复的结构信息。

它有几条很重要的边界：

未保存的文字不会写进会话文件；
Diffview 会在保存会话前自动关闭；
Explorer、Quickfix、终端和部分插件临时 Buffer 可能在手动保存时被关闭；
会话载入后，配置会重新打开 Explorer；
终端中的 shell 进程和输出不会随会话恢复。

会话不能恢复未保存的文字

由于默认关闭了 swap、backup、writebackup 和持久 undo。编辑器或系统突然退出时，未写入磁盘的文字很难恢复。应频繁保存，并使用小步 Git 提交。会话只记录布局，不能代替文件保存。

最终挑战的开始状态

确保项目有下面两个服务函数：

python

def pending_count(tasks: list[Task]) -> int:
    return sum(not task.done for task in tasks)

def completed_count(tasks: list[Task]) -> int:
    return sum(task.done for task in tasks)

测试已经全部通过，Git 工作树也应干净：

console

PYTHONPATH=src python -m unittest -v
git status --short

我们要增加 task_summary，输出：

text

1 pending / 1 completed

工作流二：建立本次开发布局

1. 明确进入项目

从普通终端运行：

console

cd ~/playground/pocket-tasks
nvim .

路径请按实际创建位置调整。带上目录参数，可以避免自动载入另一个项目的最近会话。

2. 打开测试与实现的双栏布局

刚用 nvim . 启动时，目标文件未必已经进入 Buffer 列表。可以按下面这套固定步骤打开布局：

按 Space e 打开 Explorer。

展开 tests/，高亮 test_service.py，按 Enter 打开。

焦点进入测试代码后按 Space e，关闭当前 Tab 已有的 Explorer。
按 Space /，输入 def pending_count。

高亮服务文件里的结果，按 Ctrl-v，把 service.py 竖向打开。

用 Ctrl-w 加 h/l 在两栏间移动。

现在左栏是测试，右栏是实现。分屏方向可能受当前布局影响，应根据窗口中的文件名确认内容，不要只依赖左右位置。

3. 保存一份布局快照

先按 F1 → wall →Enter → Enter，再按：

Space s c

你可能看到 Explorer 或其他工具窗口被收起，这是会话保存前清理临时 Buffer 的结果。普通文件与分屏布局会被记录。需要文件树时，再按 Space e。

工作流三：完成一轮测试驱动开发

这一轮不再增加快捷键，专心把已经学过的动作串起来。

第一步：开功能分支

按 Ctrl-\ 打开终端，运行：

console

git switch -c feature/task-summary

隐藏终端。

第二步：先写失败测试

在 tests/test_service.py 的导入列表加入 task_summary：

python

from pocket_tasks.service import (
    add_task,
    complete_task,
    completed_count,
    pending_count,
    task_summary,
    visible_titles,
)

在 ServiceTests 中加入：

python

    def test_task_summary(self) -> None:
        tasks = [
            Task(title="write docs"),
            Task(title="drink water", done=True),
        ]
        self.assertEqual(
            task_summary(tasks),
            "1 pending / 1 completed",
        )

按 Esc，用 F1 → write → Enter → Enter 保存测试。

左侧符号栏应出现诊断，因为导入目标还不存在。把光标放在 task_summary 上，按 Space l e，浮窗会显示当前诊断详情。

打开终端，直接输入并执行：

console

PYTHONPATH=src python -m unittest -v

预期出现 ImportError。这是当前阶段应有的测试失败。

第三步：从已有定义跳到实现文件

隐藏终端，在测试导入中的 pending_count 上按：

Space l g d

LSP 会跳到 service.py 的定义。也可以用 Space , 直接切到该 Buffer；路线不同，目的地相同。

在 completed_count 后加入：

python

def task_summary(tasks: list[Task]) -> str:
    return (
        f"{pending_count(tasks)} pending / "
        f"{completed_count(tasks)} completed"
    )

输入函数名时，Blink 自动补全菜单通常会出现：

用 Ctrl-n /Ctrl-p 选候选；
按 Tab 接受；
Enter 继续只负责换行。

按 Esc，保存实现文件。

第四步：检查诊断并重新运行测试

在当前文件按 ] d。若没有下一条诊断，Neovim 会提示已到边界或找不到诊断通常说明当前文件没有可报告的问题。

打开终端，按 Up、Enter 重跑测试。全部测试应通过。

Python 的 BasedPyright 不提供格式化能力，本项目里 Space c f 可能没有可执行的格式器。代码已经按清晰布局输入，直接保存即可。换到 Nix 等已有格式器的文件时，再走“格式化、等待、保存”三步。

第五步：全项目搜索验收

隐藏终端，按：

Space /

输入 task_summary。结果应至少包含：

服务函数定义；
测试文件导入；
测试调用。

用 Ctrl-n /Ctrl-p 浏览三处预览，确认后按 Esc 关闭。若想打开当前项，按 Enter；若想把全部结果留在底部逐项查看，按 Ctrl-q 加入 Quickfix。

工作流四：提交前总审查

1. 保存与测试

按 F1 → wall →Enter → Enter。打开终端运行：

console

PYTHONPATH=src python -m unittest -v
git diff --check
git status --short

确认测试通过，且只有 service.py 与 test_service.py 发生变化。

2. 用 Diffview 看完整补丁

隐藏终端，按 Space g s。

按 Tab 在两份文件之间切换。

每份文件用 ] c 逐块阅读。

需要修正时按 g f 回真实文件，修改并保存。
回 Diffview 后按 Space e，再按 R 刷新。
在文件面板对两个 Unstaged 条目分别按小写 s。

用 F1 → DiffviewClose → 两次 Enter 退出。

3. 检查 index 并提交

打开终端运行：

console

git diff --cached --check
git diff --cached

阅读补丁，按 q 退出 pager。确认无误后：

console

git commit -m "add task summary"
git status --short

工作树应该重新变为干净状态。至此，这个功能已经依次完成测试、实现、诊断检查、搜索验证、代码审查和提交。

工作流五：保存并恢复工作现场

安全退出

按 F1 → wall →Enter → Enter。
确认 Diffview 已关闭。
按 Space s c 保存当前目录会话。
按 F1，输入 wqa，连按两次 Enter。

退出时插件也会尝试自动保存当前工作目录的会话。手动保存这一步仍有价值：你明确知道快照发生在所有文件落盘之后。

恢复最近会话

在普通终端运行：

console

nvim

无参数启动会自动尝试载入全局最近会话。它适合回到刚才这个项目。载入完成后 Explorer 会自动打开，先前普通文件与分屏布局也应回来。

明确打开另一个项目

进入另一个项目时使用：

console

cd /path/to/other-project
nvim .

目录参数会阻止全局最近会话自动载入。若这个项目已有保存的布局，再按 Space s l，等待会话 Picker 出现，选择对应路径并回车。

快速载入最近会话

在已打开的 Neovim 中连续按：

Space s l t

载入会话前先保存当前内容

这个动作可能删除当前 Buffer 并切换整个布局，执行前先保存。

若当前有未保存内容，载入过程中可能出现确认：

Yes：先写入修改，再继续载入；
No：丢掉修改，继续载入；
Cancel：取消本次载入。

不确定是否应继续时，选择 Cancel。返回后使用 F1 → wall → 两次 Enter 保存，再重新载入会话。

删除旧会话记录

按 Space s d，在 Picker 中选择旧会话并确认。这只会删除布局记录，不会删除项目文件。路径相似时先查看完整预览，避免误删仍在使用的会话。

日常开发的主要流程

阶段	推荐动作
进入明确项目	`cd 项目` ，然后 `nvim .`
回最近现场	无参数 `nvim`
找文件	`Space` `e` 或 `Space` `,`
找代码	`Space` `/`
并排理解	Picker 中 `Ctrl-v`
写与重构	文本对象、`.`、补全、LSP 定义/引用/重命名
看问题	`]` `d`、诊断浮窗
运行与测试	`Ctrl-\`
格式化	有可用格式器时 `Space` `c` `f`，等待后保存
小块审查	`]` `c`、`Space` `h` `P`
全项目审查	`Space` `g` `s`
提交	Diffview/Gitsigns 暂存，终端运行 Git
结束工作	`wall`，`Space` `s` `c`，`wqa`

最终自测

不看前文，尝试回答并亲手做一遍：

怎样明确打开一个新项目，避免载入上个项目？
怎样把两个已打开文件竖向并排？
怎样在整个项目搜索一个函数名，并把结果加入 Quickfix？
怎样跳定义、找引用、重命名和查看诊断？
补全菜单里哪颗键接受候选，哪颗键继续换行？
怎样打开右侧终端、跑测试、回代码、再重跑？
怎样逐 hunk 预览和暂存？
怎样打开全项目 Diffview，又怎样完整关闭？
怎样解决下一处冲突并选择 theirs？
会话保存前，为什么仍要先保存文件？

如果有两三题无法完成，可以查看 15：完整速查表，然后立即回到项目中重复操作。查表后配合实际练习，比单纯阅读更容易形成记忆。

14｜会话与最终挑战——完整日常开发流程 ​

工作流一的新按键：保存和载入布局 ​

会话会保存哪些内容 ​

最终挑战的开始状态 ​

工作流二：建立本次开发布局 ​

1. 明确进入项目 ​

2. 打开测试与实现的双栏布局 ​

3. 保存一份布局快照 ​

工作流三：完成一轮测试驱动开发 ​

第一步：开功能分支 ​

第二步：先写失败测试 ​

第三步：从已有定义跳到实现文件 ​

第四步：检查诊断并重新运行测试 ​

第五步：全项目搜索验收 ​

工作流四：提交前总审查 ​

1. 保存与测试 ​

2. 用 Diffview 看完整补丁 ​

3. 检查 index 并提交 ​

工作流五：保存并恢复工作现场 ​

安全退出 ​

恢复最近会话 ​

明确打开另一个项目 ​

快速载入最近会话 ​

删除旧会话记录 ​

日常开发的主要流程 ​

最终自测 ​

14｜会话与最终挑战——完整日常开发流程

工作流一的新按键：保存和载入布局

会话会保存哪些内容

最终挑战的开始状态

工作流二：建立本次开发布局

1. 明确进入项目

2. 打开测试与实现的双栏布局

3. 保存一份布局快照

工作流三：完成一轮测试驱动开发

第一步：开功能分支

第二步：先写失败测试

第三步：从已有定义跳到实现文件

第四步：检查诊断并重新运行测试

第五步：全项目搜索验收

工作流四：提交前总审查

1. 保存与测试

2. 用 Diffview 看完整补丁

3. 检查 index 并提交

工作流五：保存并恢复工作现场

安全退出

恢复最近会话

明确打开另一个项目

快速载入最近会话

删除旧会话记录

日常开发的主要流程

最终自测