Thunder Client 数据丢失源于其用户数据(环境变量、请求历史、集合配置)全存于本地 .thunder-collection 目录且不参与 VSCode Settings Sync;重装插件会清除该目录,导致数据彻底丢失。

Thunder Client 数据丢失不是插件重装就能解决的,根本原因是它的环境变量、请求历史、集合配置等全部存在本地缓存中,且不走 VSCode 的 Settings Sync 通道——重装插件后这些数据就彻底清零。
为什么重装 Thunder Client 后所有请求和环境都消失了
Thunder Client 把用户数据(包括 .thunder-collection 目录、环境变量、请求标签页状态、历史记录)全存在 VSCode 的 User 目录下,但**不依赖 settings.json 存储,也不参与官方同步机制**。重装插件时,VSCode 会删掉该插件专属的缓存子目录(如 extensions/rangav.thunder-client 下的运行时数据),而用户数据目录里对应的 .thunder-collection/ 又容易被忽略或误删。
-
.thunder-collection/environments.json是多环境配置的唯一来源,手动删了或格式写错,整个环境列表就为空 - 请求历史存在
.thunder-collection/history.json,这个文件不备份,重装即失 - 如果你用过「Save as Collection」导出过 JSON 文件,那是唯一可恢复的结构化备份;否则没有“云端历史”一说
如何抢救已丢失但磁盘上还残留的数据
只要没清空整个 User 目录,就有机会从旧缓存里捞回 .thunder-collection。关键不是找插件文件夹,而是定位 Thunder Client 的用户数据落点:
- macOS:检查
~/Library/Application Support/Code/User/.thunder-collection/ - Windows:
%APPDATA%\Code\User\.thunder-collection\ - Linux:
~/.config/Code/User/.thunder-collection/
如果该目录还在,直接保留;如果被删了但你有最近的 Time Machine / 文件历史 / 备份工具快照,优先恢复这个目录。注意:.thunder-collection 必须放在 User 根目录下,不能嵌套在子文件夹里,否则 Thunder Client 启动时不会加载。
怎样避免下次再丢——真正有效的备份方式
别指望 Settings Sync,也别只导出 settings.json。Thunder Client 的数据必须单独、显式备份:
- 每次改完环境或新增重要请求后,手动执行
Collection → Export Collection,保存为thunder-collection-backup.json—— 这个文件含全部环境、请求、分组,可随时Import Collection恢复 - 把
.thunder-collection/整个目录加入你日常的配置备份脚本(比如用rsync或git管理User目录时,取消对它的 ignore) - 禁用 Thunder Client 的自动清理行为:在设置里关掉
Delete old history entries,不然它会在后台悄悄删掉 30 天前的history.json条目
重装后恢复失败?检查这三处硬编码路径依赖
即使你恢复了 .thunder-collection,也可能遇到请求发不出、环境变量不生效——大概率是 Thunder Client 内部路径引用了旧 Node.js 或扩展 ID:
- 打开设置搜索
thunderclient.nodePath,确认值仍指向当前有效的node路径(如/opt/homebrew/bin/node),重装后这个配置常被重置为空 - 检查
settings.json里有没有残留的"thunder-client.xxx"配置项,尤其是已废弃的字段(如旧版用的defaultEnvironment),它们会导致整个插件初始化失败 - Thunder Client 1.12+ 开始强制校验
.thunder-collection/environments.json的 JSON Schema,如果字段名拼错(比如写成base_url而非baseUrl),它会静默跳过整个文件——用在线 JSON Schema 验证器比肉眼检查更可靠
最常被忽略的一点:Thunder Client 的「请求历史」和「已保存集合」是两套独立存储,Export Collection 不包含历史记录,而历史记录又无法通过 UI 导入。真要保全一切,只能定期 cp 整个 .thunder-collection 目录。


















