VSCode离线文档指settings.json配置、插件内嵌缓存文档（存于Cache/globalStorage）、用户自建文档三类内容；需分别备份settings.json、触发加载后打包Cache与globalStorage、显式归档项目文档，并恢复后手动触发插件文档命令激活缓存映射。
VSCode离线文档指的是什么
VSCode 本身不提供“离线文档”这个独立功能模块，所谓“离线文档”实际是三类东西的混合体：settings.json 里的文档相关配置（比如 "editor.wordWrap": "on"）、插件自带的本地帮助页面（如 ms-python.python 的 Python 文档侧边栏）、以及用户手动保存的 Markdown / HTML 格式说明文件（比如项目根目录下的 docs/）。它们没有统一备份入口，必须按来源区分处理。
插件内嵌文档无法直接迁移
像 ms-python.python、ms-vscode.cpptools 这类插件，其“文档”其实是运行时动态加载的 Web 视图或本地资源包。这些内容不会出现在 .vscode/extensions/ 文件夹里——它只存前端代码，文档资源（如 HTML、JS、CSS）通常由插件首次激活时从 CDN 下载并缓存在 globalStorage 或 Cache 目录下。直接复制 extensions 文件夹，这部分文档必然丢失。
- Windows 缓存路径示例：
%APPDATA%\Code\Cache\*（含随机哈希名子目录） - Linux/macOS 对应路径为：
~/.config/Code/Cache/或~/Library/Caches/Code/ - 这些缓存目录结构不稳定，且无明确命名规则，不适合人工识别和打包
- 正确做法：在有网机器上完整触发一次文档加载（比如打开一个
.py文件 → 点击命令面板 → 输入Python: Show Python Documentation→ 等页面完全渲染），再关闭所有 VS Code 进程后，连同Cache和globalStorage一起打包
用户自建文档要单独归档
如果你把项目说明、API 手册、部署指南等写成 README.md、docs/index.html 放在工作区里，它们不属于 VSCode 配置体系，但常被误认为“VSCode 文档”。这类文件必须显式纳入备份范围，否则迁移后只剩空编辑器。
- 建议用相对路径组织：
./docs/或./.vscode/docs/，避免硬编码绝对路径 - 若用 VSCode 内置预览（
Ctrl+K V），注意markdown.preview.doubleClickToSwitchToEditor这类设置需同步进settings.json - 不要依赖插件自动索引（如
shd101wyy.markdown-preview-enhanced的本地图床），其上传记录存在globalStorage，同样需一并迁移
恢复时最易忽略的一步
即使你把 settings.json、Cache、globalStorage 全部拷过去，插件文档仍可能打不开——因为 VSCode 不会在启动时自动重建文档缓存映射。你得手动触发一次“重载文档上下文”：
- 打开任意一个该插件支持的文件类型（如
test.py） - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入对应插件的文档命令（例如
Python: Show Python Documentation或C/C++: Open Configuration UI） - 等待右下角状态栏出现
Ready或图标常驻，而不是一直转圈
这步漏掉，文档资源虽在磁盘上，但插件内部引用链未激活，等于白备份。
