用 DBeaver Community 连接本地 SQLite 文件并浏览数据

本文适用于已有 SQLite 数据库文件、希望在 DBeaver Community 中查看表结构或查询数据的桌面用户。连接并不自动保证数据库只读；以下流程按官方当前帮助文档整理，未在 DBeaver 26.2.2 上实机操作。具体界面文案可能随版本和系统变化。

适用环境与准备

RJ.tools 软件条目当前记录 DBeaver Community 26.2.2，支持 Windows、macOS、Linux；本教程步骤依据 DBeaver 当前滚动文档，文档未标明只适用于 26.2.2。
已安装可启动的 DBeaver Community，并有一个现存、可读取的 .db、.sqlite 或同类 SQLite 文件。本文不讲创建数据库、加密 SQLite、远程文件或 PRO 专属功能。
先关闭正在写入该文件的程序，并为原文件制作一份可恢复的副本。确认文件完整路径；选错或输错路径可能打开错误文件，切勿用重要原件试探。
浏览内容时优先使用只读限制（若当前 SQLite 连接设置提供相应选项），并只运行 SELECT 查询。若没有可确认的只读限制，不要执行修改语句；SQL 只读写法本身不等于数据库权限保证。

创建 SQLite 连接

在 DBeaver 的 Connections 视图或工具栏打开 New Connection Wizard。官方连接向导还列出 Windows/Linux 与 macOS 可用的 Ctrl+Shift+N 快捷键；若快捷键被系统或用户配置覆盖，使用向导按钮。
搜索并选择 SQLite 驱动，继续到连接设置页。首次使用时，DBeaver 可能提示下载驱动；仅按客户端向导获取驱动，等待下载完成后再继续。
在 SQLite 设置中找到 Path，填写现有数据库文件的完整路径。若窗口提供文件选择器，可用它确认路径和文件名。不要勾选 remote database，除非你的场景确实是远程数据库且已按官方远程配置文档设置。
点击 Test Connection。连接测试通过只能说明当前客户端能建立该连接，不证明文件有备份、内容正确或连接只读。确认路径无误后完成向导。
在 Connections 树展开该连接及数据库对象。若对象树没有立即更新，可选中连接刷新；只查看表结构时先展开 Tables，不打开编辑操作。

查询表清单与浏览数据

如需通过查询确认文件内容，打开该连接的 SQL Editor，运行只读示例：
```
SELECT name
FROM sqlite_master
WHERE type = 'table'
ORDER BY name;
```
结果应列出数据库中可见的表名；空结果可能表示该文件没有普通表，也可能是选错文件，先核对路径，不要据此改写数据库。
想查看具体数据时，先从表清单选定表，再在 SQL Editor 中用 SELECT * FROM 表名 LIMIT 20; 查看少量行。把“表名”替换成实际清单中的名称；遇到大小写、空格或特殊字符时，使用 SQLite 标识符引用规则，不要原样执行占位文字。
若在对象树中查看表数据，先确认当前连接和表名，再使用该表的查看数据入口。不要点保存或提交编辑；如误改且尚未提交，按当前事务状态回滚或关闭未保存编辑，并从备份恢复原件。

预期结果

连接在 Connections 树中显示；对象树可浏览数据库中的表；示例查询返回表名，或在确实没有表时返回空结果。结果只证明这次连接/读取的可见情况，不证明数据库没有损坏或已完成备份。

常见问题与恢复

Test Connection 失败： 重新核对 SQLite 驱动已安装、Path 指向可读的现存文件、文件权限及文件是否被其他程序占用。不要用新建空文件替代原数据库排错。
连接成功却看不到预期表： 检查路径、连接的文件名和表清单；不要在不确定时运行创建或修复语句。必要时断开连接，重新选择已备份的正确副本。
误选了另一份数据库： 断开连接并删除或修改本地连接配置后，重新指定正确路径。删除连接配置不等于删除数据库文件；操作前看清删除对话框目标。
担心误写入： 停止编辑和写入语句，若事务仍未提交则使用回滚；若写入已提交，关闭连接并从已验证的备份副本恢复。DBeaver 不替你自动备份，也不能保证已提交操作可撤销。
加密文件或需要远程连接： 这超出本文普通本地 SQLite 文件步骤。先阅读官方 SQLite 页面中对应的加密或远程连接部分，不要把普通 Path 流程套用过去。

核验与测试范围

DBeaver 官方 SQLite 文档说明选择 SQLite 驱动、在 Path 填数据库文件路径，并分别列出加密、远程等配置；官方 Create a connection 文档说明选择驱动、填写连接设置、Test Connection 并完成连接。以上为文档整理，2026-10-18（Asia/Shanghai）核验页面，未下载驱动、连接本地数据库或验证不同操作系统的实际菜单。资源条目列出的 26.2.2 不代表这些滚动文档已绑定该构建。

来源：

用 DBeaver Community 连接本地 SQLite 数据库文件并浏览数据

Recursos y versiones compatibles