
这个工具解决什么问题
这个场景很常见:换手机时从某个 APP 的备份里扒出一个 .db,同事发来一份导出的数据库文件让你核对「上周那批订单在不在里面」,或者自己写的程序跑完留下一个 sqlite 文件,想确认数据到底进没进去。文件就躺在文件夹里,双击打不开——Windows 不认识它。想看看内容,就得先找一个数据库客户端:下载、安装、同意协议、新建连接、选文件类型、填路径,运气不好还会因为版本不对连不上。而大多数时候你只想干一件事:看看有哪几张表、随便点开一张看看前几行、把其中一张导成 Excel 能看的表格。为了这三步装一整套数据库管理工具,装完还要担心手滑改了原文件——那多半是你唯一的一份数据。这个工具就是把这套流程压缩成「选文件 → 点表名 → 点导出」,并且从连接层面就设成只读,改不动原文件。
- 原来的做法:搜一个数据库客户端、下载安装、新建连接、选文件、填路径,再在一堆面板里找「浏览数据」;要导出还得学它自己的导出向导;全程提心吊胆别点到「保存」把原文件改了
- 用这个工具:双击程序 → 点「打开数据库文件…」选那个 .db → 左边立刻列出所有表和视图(带行数)→ 点任意一张,右边就是字段定义和数据 → 点「导出当前表…」存成 CSV
- 省下来的:从「装一个软件再学会用它」变成「打开就能看」,看一眼数据的时间从十几分钟降到十几秒;只读打开,不用担心误改唯一的那份数据
技术实现
整个程序分三层:core.py 只负责「读库」——打开文件、列表、读结构、分页取数、筛选、导出 CSV,一行界面代码都没有;gui.py 只负责「把结果摆到窗口里」;main.py 负责入口与异常兜底。这样拆的理由很实际:库文件在真实世界里很脏(表名带空格、列名带双引号、某列存着几兆二进制、表多到几百张、有的是视图不是表、有的被别人加了密),这些坑必须能在没有界面的情况下用断言一条条钉死,否则每改一次代码都要靠人点界面去试。界面这一层的难点不在长相,而在「不能卡」:SQLite 查询是同步阻塞的,百万行的表上数一次行数就要几百毫秒,直接放在按钮回调里点一下就假死。所以所有读库动作都扔进后台线程,结果通过队列回主线程再动控件——tkinter 不是线程安全的,这条线越过去就是随机的崩溃与花屏。
- 只读打开:file: URI 加 mode=ro,再加 PRAGMA query_only:连接串写成 file:<百分号编码的绝对路径>?mode=ro,并在连接后立刻执行 PRAGMA query_only=1。前者让 SQLite 在文件层拒绝写,后者在语句层再拦一道,双保险。路径必须整体百分号编码:中文路径、空格、井号都会让 URI 解析错位,# 之后会被当成锚点、? 之后被当成参数,结果就是「文件明明在却打不开」。
- 所有标识符统一走双引号转义,不做字符串拼接猜测:表名、列名一律经 quote_ident() 包成 "...",内部的每个双引号写两遍。SQLite 里表名叫 order、group 这类关键字,或者带空格("订单 明细")、带引号(weird"quote),不转义拼进 SQL 就是语法错。自测里专门造了这两类脏名字各一张表来钉这条规则。
- 搜索走参数绑定,LIKE 的 % 与 _ 单独转义:关键词直接来自输入框,拼进 SQL 就是实打实的注入风险,所以全部用 ? 占位符绑定。另一个容易被忽略的点是 LIKE 的通配符:用户搜「50%」时 % 会被当成「任意字符」,搜出一堆不相关的东西。处理顺序是先转义反斜杠本身、再转义 % 和 _,配合 ESCAPE '\' 使用;自测里有一条专门断言「搜 50% 只命中 1 行」。
- 一个任务一个连接,全部在后台线程里跑:sqlite3 的连接默认绑定创建它的线程,跨线程用会抛 ProgrammingError;加 check_same_thread=False 能绕开,但多线程共用同一连接要自己保证串行,反而更容易出隐蔽 bug。开连接只有微秒级开销,所以每次查询现开现关,顺手还保证了读到的是最新落盘状态。
- 先出表清单、再逐张补行数:列一张表几乎是瞬时的,但数一张表的行数是全表扫描,几十万行就要几百毫秒。所以打开文件时先只取表名(sqlite_master 一次查询),行数由后台线程一张一张数、数完一张就刷新一行。表多的库不会出现「转圈十几秒然后突然全出来」。
- CSV 按 Excel 的口味写:utf-8-sig + CRLF + 分批流式:编码用带 BOM 的 UTF-8,Excel 双击打开中文才不乱码(没有 BOM 的老版 Excel 会按本地编码猜,中文全是问号);换行用 CRLF,同时 open 时 newline="" 避免 Python 再翻译一次写出 \r\r\n。数据用 fetchmany(500) 分批读,不把整张表读进内存——几十万行的表一次读进来会吃掉几百兆。
- 二进制列只显示长度,超长文本在表格里截断:库里存图片、存压缩包是常事,把几兆的字节直接塞进 Treeview 会让界面卡死,所以 bytes 只显示「<二进制 N 字节>」,双击看详情时给前 64 字节的十六进制摘要;超过 200 字的文本在表格里截断并标注总长度,完整值在双击的详情窗口里看。
技术栈:Python 3.8+、tkinter 图形界面、标准库 sqlite3 + csv(运行期零第三方依赖)、PyInstaller 单文件打包
已知局限:只支持未加密的 SQLite 单文件库(.db / .sqlite / .sqlite3 / .db3),Access、MySQL、SQL Server 的库打不开;全程只读,不能改数据、不能建表删表;字段超过 40 个的宽表,界面只显示前 40 列(导出 CSV 时仍是全部列);关键词搜索是 LIKE 全字段扫描,几百万行的大表搜一次要等一会儿;表格里的数据是文本形式展示,二进制内容不做还原。
同类软件对照
下面几款都是公开可查的同类软件,定位各不相同。这里只说明各自的定位,以及本工具在其中的位置,方便你判断哪一类更契合自己的用法。
| 软件 | 它的定位 | 本工具的定位 |
|---|---|---|
| DB Browser for SQLite | 开源的跨平台 SQLite 图形客户端,覆盖建表、改数据、导入导出等完整操作 | 定位窄得多:只读浏览加 CSV 导出,不提供任何修改入口;不需要安装与配置,解压双击就能用,界面只有「选文件、看表、导出」三块。 |
| SQLiteStudio | 跨平台 SQLite 管理工具,支持多库同时打开、SQL 编辑器与插件扩展 | 本工具不需要懂 SQL,打开就是表格;单文件几十兆,不需要安装运行库,适合「只想看一眼这个文件里有什么」的场合。 |
| DBeaver | 通用数据库客户端,支持数十种数据库与连接管理 | 本工具只处理 SQLite 单文件,省掉新建连接、填驱动、选库类型这些步骤;打开方式就是把文件选进来。 |
| Excel / WPS 表格 | 电子表格软件,适合查看与分析表格数据 | 它们打不开 .db 文件,需要先有一次「从库到 CSV」的转换;本工具做的就是这一步,并且支持一次把库里所有表各导一个 CSV。 |
以上仅作定位对照,各软件的可用性、授权方式与功能范围请以其官方页面为准。
操作教程
- 解压后双击「数据库文件速览.exe」
不需要安装 Python 或任何运行库,程序直接打开一个窗口。也可以把 .db 文件拖到 exe 图标上启动:文件会自动打开并直接选中第一张表。
预期结果:窗口打开,顶部是「打开数据库文件…」按钮;拖文件启动时左侧已列出表,右侧直接显示第一张表的数据 - 点「打开数据库文件…」,选中你的 .db 文件
文件对话框里默认列出 .db / .sqlite / .sqlite3 / .db3,也可以切到「所有文件」自己找。程序以只读方式打开,不会改动原文件。
预期结果:左侧出现「表(N)」「视图(M)」两组,每个名字后面的行数会一张张陆续填上 - 在左侧点一张表
右上显示这张表的字段定义(名字、类型、是否主键、是否非空、默认值),右下显示数据,每页 200 行。
预期结果:右侧表格出现数据;底部状态栏显示「共 N 行 · 本页 200 行 · 用时 X ms」 - 要定位某条记录,就在「在当前表里搜」里输入关键词
会在所有字段里找包含这个词的行,中文、数字都能搜;% 和 _ 会当成普通字符处理。点「清除」恢复全表。
预期结果:表格只剩命中的行,状态栏的总行数变成命中数 - 点「导出当前表…」存成 CSV
如果当前还带着搜索词,会先问你是只导命中的行还是整张表。存出来的 CSV 用 Excel / WPS 双击即可打开,中文不乱码。
预期结果:弹出「导出完成」,显示导出了多少行、存到了哪个路径 - 要把整个库都拿出来,点「全部表导出…」选一个文件夹
每张表导出成一个 CSV,文件名就是表名(表名里不能做文件名的字符会换成下划线)。导出过程有进度显示,单张表失败不影响其它表。
预期结果:结束后弹窗告诉你成功几张、共多少行,失败的会列出表名与原因
常见问题
技术实现与后续维护
程序按「读库逻辑 / 界面 / 入口」三层拆开,读库逻辑完全不含窗口代码。调整筛选规则、导出格式不会碰到界面;改界面也不会影响取数结果——这也是它敢直接打开别人给的陌生库的原因:出问题能立刻定位到是哪一层。运行环境只有一条要求:Windows 10/11 64 位,不需要装 Python、不需要装运行库,解压双击即可。每次迭代会先跑一遍不依赖界面的自测(81 项断言,覆盖文件识别、表清单、字段结构、脏标识符、分页、通配符转义、CSV 编码与换行、只读保护、大表耗时),再跑一遍界面冒烟(21 项,验证窗口、清单、数据、翻页、搜索、空表与宽表都不崩),两项都过才发布。
可扩展方向:
- 加「结构对比」:拿两个版本的同一个库比字段差异,用于升级前后的核对
- 加「按条件导出」:除了关键词,再支持「某列等于/大于某值」的条件筛选后导出
- 加「导出为 Excel 多工作表」:一个 xlsx 里每张表一个 sheet,省去来回切文件
- 加「库文件体检」:页数、空闲页比例、索引数量、重复索引提示,用于判断库是否需要整理
本工具免费提供使用,功能完整、不设限制。如果你需要在本工具基础上做功能调整、对接内部系统或长期维护,可以联系我们做二次开发。
需要其它功能?可以定制
这个工具只做一件事:手里有一个 .db / .sqlite 文件,想知道里面有哪些表、数据长什么样,却不想为看一眼就装一个几百兆的数据库软件。如果你的场景还需要别的处理,可以联系我们做二次开发,按你的实际数据格式和流程定制。
常见的定制需求:
- 在自己的业务系统里对接:把某个 .db 的指定表每天导成固定格式的 CSV 交给下游
- 按固定字段顺序与编码(GBK)导出,适配老系统的导入要求
- 把多个同结构的 .db 合并成一张总表后导出
- 只导出满足业务条件的行(如某时间段、某状态),并加上来源文件名一列
- 联系方式:邮箱/微信见站内「联系我们」页面,或在本文下方留言
- 定制说明:请附上你的数据样例(脱敏即可)和期望结果,方便快速评估工作量
- 交付形式:定制项目交付可执行程序,支持后续版本迭代与长期维护
使用说明与免责声明
- 本工具在本地运行,不联网、不上传任何数据到服务器。
- 涉及文件改写的功能,请在使用前备份原始文件。
- 软件完全免费,可自由使用与转发,请勿用于倒卖。
- 因误操作造成的数据问题请自行承担。
本工具对数据库文件只读:不会修改、不会删除你选择的原文件,也不生成任何附属文件;「导出」写出的是全新的 CSV,与你打开的数据库文件互不影响。如果你需要改动数据本身,请先复制一份再使用其它数据库管理工具操作。

