Navicat 连接 SQLite 必须用绝对路径且不能留空用户名密码；相对路径、tilde、环境变量均无效；文件被占用或 WAL 模式会导致无表、修改丢失等问题。
SQLite 文件路径必须是绝对路径，相对路径会静默失败
navicat 连接 sqlite 时不会报错提示“路径不存在”，而是直接显示空数据库或连接成功但无表——实际是因为它找不到 database.db。根本原因是 navicat 的 sqlite 驱动只接受绝对路径，且不支持 tilde（~/）或环境变量展开。
- ✅ 正确做法：在“Database File”栏粘贴完整路径，如
/Users/you/project/data/app.db（macOS/Linux）或C:\dev\myapp\data.db（Windows） - ❌ 常见错误：填
./data.db、data/db.sqlite、~/Documents/test.db—— 全部无效 - ⚠️ 注意：路径中含空格或中文通常没问题，但建议先用 Finder / 文件资源管理器复制“显示简介”里的完整路径，避免手动输错斜杠方向
无需用户名密码，但“User Name”和“Password”字段不能留空
SQLite 是无服务端的嵌入式数据库，Navicat 却沿用了通用连接表单设计，强制要求填写 User Name 和 Password 字段。留空会触发校验失败，提示“Connection failed”，而非“authentication required”之类明确信息。
- ✅ 解决方案：任意填两个非空字符串，例如
user和pass—— 它们完全不参与认证，只是绕过前端校验 - ⚠️ 陷阱：有人误以为要填系统用户名，或尝试用 SQLite 的 PRAGMA key（加密）参数，其实 Navicat 当前版本（v17.0+）不支持 SQLite 加密数据库直连
- ? 补充：如果真要用 SQLCipher 加密库，得先用命令行工具解密导出为普通 SQLite，再连
连接后看不到表？检查文件是否被其他进程占用
SQLite 使用文件锁机制，一旦有另一个程序（比如 Python 脚本、VS Code 插件、甚至另一个 Navicat 标签页）正打开该文件，Navicat 就只能读到 schema 的初始状态（常为空），且不报错。
- ✅ 快速排查：终端执行
lsof | grep your.db（macOS/Linux）或handle.exe your.db（Windows + Sysinternals）看谁在占用 - ✅ 临时解决：关闭所有可能访问该文件的程序，包括 IDE 中已打开的 .db 文件、正在运行的
sqlite3 your.db交互会话 - ⚠️ 特别注意：某些日志型应用（如 Electron App、微信开发者工具）会在后台持续 hold 住 SQLite 文件，仅关闭 UI 不够，需彻底退出进程
Navicat 对 WAL 模式支持有限，写操作可能卡住或丢失
SQLite 默认用 DELETE 模式，但很多现代应用（尤其是移动端或桌面端）启用 WAL（Write-Ahead Logging）提升并发。Navicat 在 WAL 模式下无法可靠提交事务，有时点击“保存”没反应，有时改完数据刷新就消失。
- ✅ 确认当前模式：用命令行执行
sqlite3 your.db "PRAGMA journal_mode;"，返回wal即表示启用 - ✅ 临时切换：运行
sqlite3 your.db "PRAGMA journal_mode = delete;"，再重连 Navicat - ⚠️ 权衡：WAL 提升多读少写场景性能，但 Navicat 本质是单点 GUI 工具，日常维护用 DELETE 模式更稳；若必须保留 WAL，请只用 Navicat 查看，修改仍走脚本或代码
SQLite 的连接逻辑比看起来更“脆弱”——它不依赖网络、不校验凭证、不提示路径问题，所有失败都藏在静默里。最常卡住的地方不是配置，而是你根本没意识到文件正被别的进程锁着，或者以为相对路径能自动解析。
