推荐alexcvzz版sqlite插件,图标为蓝色圆柱体,安装量超500万;需确保文件后缀为.db或.sqlite、路径无中文空格、未被占用,否则90%的“连不上”问题由此导致。

VSCode 本身不支持 SQLite,必须靠插件;装错插件或路径写错,90% 的“连不上”问题就出在这儿。
SQLite 插件选哪个:alexcvzz 版本最稳,别被名字带偏
扩展市场搜 “SQLite”,会出现多个同名插件。唯一推荐的是由 alexcvzz 发布的 SQLite 插件(图标是蓝色圆柱体,安装量超 500 万)。它不依赖额外驱动、不弹连接向导、打开 .db 或 .sqlite 文件即用。
常见误区:
- 装了
SQLTools却没装配套的SQLTools SQLite Driver→ 连接显示成功,但查不到任何表 - 误装了叫
SQLite Viewer(qwtel 开发)的插件 → 功能强但对大文件卡顿,且部分版本不支持直接双击打开数据库 - 看到 “SQLite3” 字样就点安装 →
sqlite3是命令行工具名,不是插件名,装了也没用
SQLTools 配置 SQLite 必须填绝对路径 + 小写 driver
如果你坚持用 SQLTools(比如要管理多个数据库或导出 CSV),它的配置非常严格:
-
database字段必须是绝对路径:Windows 写C:/project/data/app.db,macOS/Linux 写/Users/name/project/app.db;./data/app.db或~/data/app.db会静默失败 -
driver和dialect都得填sqlite(全小写,不能是sqlite3或SQLite) - 配置项需手动编辑
sqltools.connections,不要依赖图形向导——Beta 版向导默认填sqlite3,必须改掉
验证是否真连上:执行 SELECT name FROM sqlite_master WHERE type = 'table';。如果返回空或报错 no such table: sqlite_master,基本就是路径或 driver 配错了。
双击打开 .db 文件没反应?检查文件后缀和权限
装好 alexcvzz 版插件后,右键 .db 文件 → “Open Database”,若编辑器区域无变化,可能原因有:
- 文件后缀不是
.db或.sqlite(如.sqlite3或.dat)→ VSCode 不识别,需重命名为.db - 文件被其他进程占用(如 Python 脚本正以
connect(..., timeout=...)打开且未 close)→ 关闭相关程序再试 - 文件权限不足(尤其 macOS/Linux)→ 终端执行
ls -l app.db确认当前用户有读权限;Windows 下检查属性里“只读”是否勾选 - 数据库文件损坏 → 用命令行
sqlite3 app.db ".tables"测试能否列出表,若报错file is encrypted or is not a database,说明不是合法 SQLite 文件
查不到数据?注意表名大小写和引号
SQLite 默认不区分大小写,但如果你建表时用了双引号,比如 CREATE TABLE "UserProfile",那表名就变成大小写敏感的标识符。插件自动生成的查询语句(如点击表名插入的 SELECT * FROM userprofile;)会查不到结果。
正确做法:
- 先运行
SELECT name FROM sqlite_master WHERE type = 'table';,看真实表名(含大小写和引号) - 若表名含大写字母,查询时必须加双引号:
SELECT * FROM "UserProfile"; - 长期建议:建表统一用小写+下划线(
user_profile),避免所有引号相关问题
真正麻烦的不是功能缺失,而是插件在“看似正常”的状态下给出错误结果——比如表名大小写不匹配时,它不报错,只返回空集。这种静默失败最容易让人浪费半小时反复检查 SQL 语法。











