能直接查看SQLite数据库文件,需同时满足路径无中文/空格、文件未被占用、后缀为.db或.sqlite;推荐SQLite Viewer(qwtel版)秒开拖入即表格化渲染,或SQLite(alexcvzz版)带侧边栏与SQL执行面板供深度调试。

能直接看,但必须满足三个硬性条件:文件路径无中文/空格、未被其他进程锁住、后缀是 .db 或 .sqlite。 其他所有“打不开”“显示问号”“查不到数据”的问题,90% 都卡在这三处,而不是插件装错了或数据库坏了。
为什么双击 app.db 还是乱码或报 unable to open database file
VSCode 默认把 .db 当纯文本二进制文件打开,自然是一堆不可读字节。SQLite Viewer 插件只有在「正确上下文」下才会接管渲染逻辑——它不靠文件编码,而是调用 SQLite C 接口直读页结构。
- 路径含中文或空格(如
C:\我的项目\app.db)→ 改成全英文路径,或把整个父目录拖进 VSCode 作为工作区,再从资源管理器里点开 - 文件正被 Android App、Python 脚本或另一个数据库工具占用 → 在任务管理器中搜
python、adb、DB Browser强制结束,尤其注意后台挂着的调试进程 - 后缀是
.sqlite3→ SQLite Viewer 只认.db和.sqlite,手动重命名为app.sqlite即可 - VSCode 没信任当前文件夹 → 右下角弹出 “Do you trust the authors of this folder?” 时务必点
Trust Folder,否则插件无权访问文件系统
SQLite Viewer 和 SQLite(alexcvzz 版)到底该选哪个
取决于你当前动作:是快速核对数据,还是边写代码边调试。
- 要秒开、拖进去就看、导出 CSV 核验字段值 → 用
SQLite Viewer(qwtel 版),它不加侧边栏、不改界面,双击即表格化渲染 - 要写
SELECT * FROM users WHERE created_at > ?、需要执行面板、想看索引/触发器结构 → 用SQLite(alexcvzz 版),它带左侧数据库树和 SQL 执行区,Ctrl+Enter 就跑查询 - 别装
SQLTools来应付这个场景——它必须手动配连接、填绝对路径、还要额外装 Driver,不是“开箱即看”
看到表名但点不开、字段全是问号、刷新没反应
这不是编码问题,也不是插件 bug,是 SQLite Viewer 的行为边界被误用了。
- 表名正常但点开后内容为空或全是
?→ 检查文件大小是否为 0,或者是否导出时 App 还在写入(未 close 连接),导致文件头损坏;可尝试用file app.db命令确认是否真为 SQLite 3.x 格式 - 字段值截断(比如 TEXT 字段只显示前 20 字符)→ 查看建表语句是否用了
TEXT COLLATE RTRIM或自定义函数,这是 SQLite 自身限制,非插件渲染问题 - Python 脚本刚插入新记录,VSCode 里却看不到 → SQLite Viewer 不监听文件变更,必须右键对应表名 →
Refresh Table,否则永远是打开那一刻的快照 - 导出 CSV 后 Excel 打开中文乱码 → 不是插件问题,是 Excel on Windows 默认不识别 UTF-8 无 BOM;用记事本另存为“UTF-8 with BOM”,或在 Excel 中选「数据 → 从文本/CSV」并指定 UTF-8 编码
最常被忽略的一点:SQLite Viewer 绕过文本解析,所以它能在部分页损坏时恢复可读内容,但也因此完全不处理编码层逻辑——如果你看到问号,第一反应不该是调 VSCode 的编码设置,而应检查文件是否真的加载成功、是否被锁、是否路径合法。











