敏捷插件不自动同步看板状态，只同步配置和文件路径；其状态依赖本地markdown/json文件，需通过git、云盘或sftp手动同步源文件，且插件配置必须正确定位文件路径。
敏捷插件不自动同步看板状态，只同步配置和文件路径
VSCode 里所谓“敏捷开发辅助工具”（比如 kanban-board、vscode-todo-plus、Todo Tree）本身不提供跨设备数据同步能力。它们读取的是本地 Markdown 或 JSON 文件里的任务列表，同步行为完全取决于你如何管理这些源文件——插件自身不会把“待办 ✔️”或“进行中 ➡️”状态上传到云端。
常见错误现象：在 A 电脑上把某条 todo 标为 done，B 电脑打开同一项目却还是 pending。这不是插件 bug，而是因为：TODO.md 文件没提交 Git、没用云盘同步、也没配置 SFTP 自动上传。
- 插件只监听工作区内的文件变更（如保存
tasks.md），不主动连接服务器或第三方账号 - 所有状态都落盘为纯文本，没有内置数据库或远程 API 调用
- 如果你用的是相对路径（如
"kanban-board.files": ["./docs/boards/*.md"]），换设备后路径错位会导致插件找不到文件，直接显示空看板
同步看板数据的三种可行路径
想让多台设备看到一致的看板，必须明确选择一种底层同步机制，而不是依赖插件本身：
-
Git 托管 + 分支协作：把
board.md提交到仓库，每次切换设备先git pull。适合团队协作，但需手动 commit/push，不适合高频实时更新 -
云盘挂载工作区：将整个项目目录放在 Dropbox / iCloud / OneDrive 同步文件夹内。注意：部分插件（如
kanban-board）在文件被云盘临时锁定时会读取失败，表现为看板空白或加载中不动 -
SFTP 插件单向推送到共享服务器：配置
sftp.json把boards/目录设为"uploadOnSave": true，所有设备都从同一远程路径读取。缺点是不支持反向同步（服务器改了，本地不会自动拉）
为什么 Todo Tree 的标签跳转在新设备上失效
Todo Tree 不同步“跳转目标”，只同步它自己的设置项（如 todo-tree.filtering.includeGlobs）。真正决定能否 Ctrl+Click 跳转的，是当前工作区里是否存在匹配的源码文件。
- 你在 A 电脑的
src/utils.js里写了// TODO: refactor this，Todo Tree能跳转 - B 电脑没拉全项目代码（比如漏了
src/目录），点击 todo 行只会报错Unable to open 'utils.js': File not found - 即使同步了
settings.json和插件列表，也无法解决路径缺失问题
真正容易被忽略的是：所谓“看板同步”，本质是「源文件位置可访问 + 插件配置能定位到它」两个条件同时满足。少一个，状态就断链。别指望插件替你管文件在哪里。
