DBeaver连接配置迁移：完整工作空间克隆指南

1. 这不是简单的“复制粘贴”而是数据库连接资产的完整迁移DBeaver 是我日常工作中打开频率最高的桌面应用之一——没有之一。它不像浏览器那样只是“用一下”而是承载着几十个生产环境、测试库、本地开发实例的连接凭证、SQL模板、历史执行记录甚至还有自定义的元数据过滤规则和结果集格式化偏好。这些配置加起来已经不是“设置”二字能概括的而是一整套个人数据库工作流的数字分身。很多人第一次换电脑时下意识地以为只要重装 DBeaver、再一个个手动填一遍 JDBC URL 和密码就行结果花两小时配完第三天发现某个 Oracle 连接里漏掉了关键的oracle.net.wallet_location参数导致 SSL 连接失败又或者 PostgreSQL 连接里没同步SSL ModeRequire和对应的证书路径连不上内网集群。更隐蔽的问题是DBeaver 的“连接配置”远不止 connection.xml 里的那些字段——它还深度耦合在工作空间workspace目录下的.metadata、.dbeaver隐藏文件夹里涉及驱动缓存、最近打开的 SQL 编辑器状态、甚至是自定义的 ER 图布局。所以“导出连接配置并迁移到新电脑”这件事本质是一次轻量级但高精度的开发者工作环境克隆核心诉求有三个第一确保所有连接能 100% 复现包括冷门数据库如 Informix、Firebird的特殊驱动参数第二保留连接分组、图标标记、别名等组织结构避免在新环境里面对 50 个无序排列的连接名抓瞎第三不泄露敏感信息比如明文密码或私钥路径。这正是为什么单纯拷贝connections.json或导出 XML 文件常会失败——你导出的只是“骨架”而真正让连接活起来的“神经和肌肉”藏在 workspace 的毛细血管里。接下来我会从底层目录结构开始拆解告诉你哪些文件必须搬、哪些可以跳过、哪些看似安全实则危险以及如何用一条命令完成 95% 的自动化迁移最后再补上那 5% 手动校验的关键动作。2. 深度解析 DBeaver 的配置存储机制为什么“导出”二字容易误导人2.1 配置不是集中存放而是三层嵌套式分布DBeaver 的配置体系绝非一个“设置中心”而是典型的 Eclipse 衍生架构——高度模块化、多层级、强依赖工作空间workspace。很多用户卡在第一步就是误判了配置的物理位置。我们先明确三个核心概念全局配置Global Settings位于用户主目录下的.dbeaver4Windows 是%APPDATA%\DBeaverDatamacOS 是~/Library/DBeaverData这里存放的是软件级设置比如字体大小、主题、SQL 编辑器快捷键、默认驱动下载源。这部分对连接迁移影响极小除非你重度定制了 SQL 格式化规则或自定义了 JDBC 驱动仓库地址。工作空间配置Workspace Settings这是迁移的核心战场。当你首次启动 DBeaver 时它会提示你选择一个工作空间目录默认是~/DBeaverData或C:\Users\XXX\DBeaverData。这个目录下藏着所有连接的“生命体征”General/.dbeaver/data-sources.json这是最常被提及的“连接配置文件”但它只保存连接的基本元数据名称、URL、驱动类型、用户名不包含密码、SSL 证书路径、高级连接属性如 Oracle 的 TNS alias、MySQL 的 useSSLtrue、甚至不保存连接所属的文件夹分组结构。General/.dbeaver/credentials-config.json这才是密码和敏感凭证的真正落脚点。它采用 AES 加密密钥由 DBeaver 自行生成并绑定到当前机器所以直接拷贝这个文件到新电脑密码会全部失效——因为新机器的加密密钥完全不同。这也是为什么官方导出功能默认不包含密码。项目级配置Project Settings如果你启用了“项目”模式Project Explorer 视图每个项目目录下会有.project和.dbeaver/project-settings.json里面可能包含该项目专属的连接定义。这种模式在团队协作中更常见但对单机迁移影响不大除非你明确使用了项目来组织连接。提示不要试图用文本编辑器直接修改># Linux/macOS 终端推荐保留符号链接和权限 cd /path/to/your/DBeaverData tar -czf dbeaver-migration-backup.tar.gz .dbeaver/data-sources.json .dbeaver/credentials-config.json .dbeaver/drivers/ .dbeaver/templates/ .dbeaver/resources/# Windows PowerShell管理员权限运行 $workspace C:\Users\Alice\DBeaverData Compress-Archive -Path $workspace\.dbeaver\data-sources.json, $workspace\.dbeaver\credentials-config.json, $workspace\.dbeaver\drivers, $workspace\.dbeaver\templates, $workspace\.dbeaver\resources -DestinationPath $workspace\dbeaver-migration-backup.zip关键点说明我们只打包>import json import os # 读取密码 CSV假设第一行是 header passwords {} with open(dbeaver_passwords.csv) as f: for line in f.readlines()[1:]: # 跳过 header name, user, pwd line.strip().split(,) passwords[name.strip()] {user: user.strip(), password: pwd.strip()} # 读取># Windows PowerShell管理员 mklink /D C:\certs C:\DBeaver-Certs# macOS/Linux ln -s /Users/Bob/DBeaver-Certs /certs批量修正连接配置用文本编辑器VS Code打开>{ folders: [ { id: f1, name: Production, children: [conn-uuid-1, conn-uuid-2] }, { id: f2, name: Development, children: [conn-uuid-3] } ] }其中conn-uuid-*必须与>