VSCode敏捷看板插件高效操作快捷键

需要明确的是，VSCode 本身并不自带原生看板功能，这一点必须提前说明。所谓的“敏捷看板插件”，实质上是借助 Markdown 文件配合轻量级插件（例如 Todo Tree、kanban-board）来模拟看板逻辑。这类工具并不提供拖拽式的 UI 看板，而是通过 Markdown 列表、标签以及侧边树形视图来实现任务追踪。因此，提高操作效率的关键并非“拖拽卡片”，而是快速定位、标记、刷新与跳转。

快速打开并聚焦看板文件（.md）

大多数看板文件以 TODO.md、BOARD.md 或项目根目录下的 kanban.md 形式存在。依靠鼠标逐一点击效率太低，建议直接使用模糊搜索来快速定位：

• 定位文件：使用 Ctrl + P（Windows/Linux）或 Cmd + P（macOS），输入 TODO 或 kanban，回车即可打开看板文件。
• 路径粘贴法：如果文件名不固定，可以在资源管理器中右键该文件，选择“复制路径”，然后通过 Ctrl + P 粘贴路径（支持相对路径补全）。
• 避免使用 Ctrl + O：这个快捷键不支持模糊匹配，在多层级项目中效率极低，不推荐使用。

在看板 Markdown 中批量更新状态标签

典型的看板条目格式如下：- [ ] 【TODO】重构登录校验逻辑 或 - [x] 【DONE】添加单元测试。手动修改方括号和标签效率低下，推荐使用批量操作：

• 批量打钩：按 Ctrl + F 搜索 [ ]，按 Enter 定位到第一个未完成项；再按 Ctrl + D 逐个选中所有未完成项，然后输入 [x] 一键完成打钩。
• 批量替换标签：如果需要统一修改标签（例如将所有 【TODO】 替换为 【IN-PROGRESS】），先按 Ctrl + H 打开替换面板，勾选“正则表达式”（.* 图标），搜索 【TODO】，替换为 【IN-PROGRESS】。
• 注意：不要使用 Ctrl + Shift + H（全局替换），它会污染代码文件；请仅在当前看板文件内操作。

用 Todo Tree 插件实时同步看板状态

Todo Tree 虽然本身并非看板插件，但在看板工作流中扮演着“中枢”角色——它能够将散落在各文件中的 // TODO、/* FIXME */ 提取为可过滤的侧边树。启用后，必须配置快捷键才能实现高效联动：

• 自定义快捷键：默认没有快捷键打开侧边树，需要手动点击图标。建议打开 Preferences: Open Keyboard Shortcuts，搜索 todo-tree: toggle，绑定为 Ctrl + Alt + T。
• 快速跳转：点击树中某条 TODO 时，光标会自动跳转到源码对应行。此时按 Ctrl + G 可以快速确认所在文件行号，避免在长文件中迷失方向。
• 新增任务：无需切换回 TODO.md。可以在任意源码文件中写入 // TODO @board: 实现导出 CSV，保存后 Todo Tree 会自动收录，并支持按 @board 过滤。

刷新看板视图与避免缓存错觉

部分看板插件（如 kanban-board）依赖本地 Markdown 渲染，修改后不会自动刷新，容易误判状态已更新：

• 强制刷新预览：修改完 TODO.md 后，按 Ctrl + K V（Windows/Linux）或 Cmd + K V（macOS）强制重载预览窗格（前提是已打开预览）。
• 预览窗格管理：如果使用 Markdown Preview Enhanced，右键菜单中有“Open Preview to the Side”，但关闭后再打开不会继承上次滚动位置。建议始终保留预览窗格在右侧，使用 Ctrl + 拆分编辑器，实现左写右看。
• 最易忽略的一点：VSCode 的文件监视默认对大文件夹禁用。如果看板文件位于 node_modules 或 dist 目录下，根本不会触发变更监听。务必确保看板文件在工作区根目录或子目录下，且未被 files.watcherExclude 配置排除。