vscode需装sqlite viewer插件才能查看.db文件，且必须在工作区根目录下打开、取消只读设置、表含主键才支持编辑；路径错误、只读启用或无主键是“打不开”“不能改”的三大静默原因。
VSCode 本身不支持直接查看或编辑 SQLite 数据文件，必须依赖扩展；最稳定、轻量且支持编辑的方案是 SQLite Viewer（作者：qcommons），但默认配置下它不启用写入功能，容易误以为“打不开”或“只能看不能改”。
安装 SQLite Viewer 扩展后打不开 .db 文件？
常见现象：双击 data.db 文件，VSCode 弹出空白页或提示“无法预览”，甚至报错 Failed to load database: Error: SQLITE_CANTOPEN。
- 根本原因不是文件损坏，而是该扩展默认只允许打开**当前工作区根目录下**的 SQLite 文件 —— 如果你从资源管理器拖入、或在非工作区路径下打开，它会静默拒绝加载
- 解决办法：先用 VSCode 打开包含
.db文件的文件夹（即执行File → Open Folder...），再在侧边栏中点击该文件 - 如果仍失败，检查文件权限：Windows 下确认没被其他进程（如 DB Browser、Python 脚本）独占占用；macOS/Linux 下注意文件是否为只读（
chmod 644 data.db）
为什么点开后只能查表、不能编辑数据？
SQLite Viewer 默认以只读模式打开数据库，这是安全设计，但文档没显式说明，用户常误以为功能缺失。
- 启用编辑需手动修改设置：打开 VSCode 设置（
Ctrl+,或Cmd+,），搜索sqlite viewer readonly，取消勾选Sqlite Viewer: Readonly - 修改后需**重新打开数据库文件**（关闭再双击），否则编辑按钮（铅笔图标）不会出现
- 编辑生效的前提是：表必须有主键（哪怕只是
rowid），否则保存时会报Cannot update table without primary key
执行 SQL 查询时提示 “no such table” 或字段名不补全？
这是因为 SQLite Viewer 的查询面板默认连接的是“当前打开的数据库”，但如果你在多数据库场景下切换过，或使用了附加数据库（ATTACH），它的元数据缓存可能未刷新。
- 强制刷新表结构：右键数据库文件 →
Refresh Schema（或按Ctrl+Shift+P输入 “SQLite: Refresh Schema”） - 复杂查询建议用内置的 SQL 编辑器（点击顶部
SQL标签页），而非直接在表视图里输 WHERE 条件 —— 后者仅支持简单过滤，不解析 JOIN 或子查询 - 注意：该扩展不支持参数化查询（如
WHERE id = ?），所有?会被当作字面量处理，需手动拼接字符串值
真正麻烦的不是装不上，而是它对路径、只读开关、主键约束这三个点完全静默——没报错、没提示、也没文档入口。调完这三项，基本就稳了。
