vscode的settings sync仅同步配置文件（如settings.json、扩展列表等），不处理项目文档；离线文档同步需依赖文件系统级方案，如符号链接+云盘、git或syncthing。
VSCode 本身不提供“离线文档”同步功能，所谓离线文档共享，实际是指本地 Markdown、HTML、PDF 或其他静态文档在多台设备间保持一致——它和 Settings Sync、Live Share 完全无关，得靠文件同步机制本身来解决。
为什么不能用 Settings Sync 同步你的文档
Settings Sync 只处理 VSCode 的用户配置：比如 settings.json、keybindings.json、扩展 ID 列表、代码片段等。它**完全不碰你打开的任何项目文件或文档**，哪怕你把文档放在 ~/Library/Application Support/Code/User/ 下也一样被忽略。试图把它当网盘用，只会发现改了文档另一台设备毫无反应。
真正有效的离线文档同步方式只有三种
这三种方案都不依赖 VSCode 插件或账户体系，而是操作系统或云服务层面的文件同步：
-
符号链接 + 云盘（推荐）：把文档所在文件夹移到 iCloud Drive / OneDrive / Syncthing 同步目录，然后在 VSCode 工作区里用
ln -s（macOS/Linux）或mklink（Windows）指向它。VSCode 打开的是软链接，内容实时更新，且不上传到 VSCode 服务器 -
Git 管理（适合技术文档）：把文档仓库克隆到每台设备，用
git pull和git push手动同步。好处是带历史版本、可 diff、支持分支隔离；缺点是需命令行操作，不适合纯小白 - 第三方同步工具（如 Syncthing）：自建 P2P 同步，不经过云端，所有文件直传设备间。适合对隐私敏感、或有局域网高速传输需求的场景；但首次配置略复杂，需每台设备都安装并配对
常见踩坑点：路径硬编码和相对引用失效
如果你的文档里嵌了图片、链接或 include 了其他本地文件，跨设备后容易 404——因为路径变了。要注意：
- 避免在 Markdown 中写绝对路径，如
/Users/me/docs/img.png；统一用相对路径，如./img.png - VSCode 的预览插件（如
Markdown Preview Enhanced）可能缓存旧路径，改完结构后要重启预览或按Ctrl+Shift+P→Markdown: Refresh Preview - PDF 文档无法被 Git 追踪变更内容，仅能同步二进制文件；若需版本对比，得转成 Markdown 或使用专门的 PDF diff 工具
离线文档同步的本质是“让文件本身在多端一致”，而不是让 VSCode 去管它。选对同步层（文件系统 or Git），再约束好路径写法，比折腾插件可靠得多。
