navicat连接sqlite必须使用绝对路径且用户名密码留空；填相对路径或波浪号会静默失败导致表为空，填用户名密码会导致连接失败，wal模式或文件被占用会引起无表、锁库等问题。
填了相对路径或波浪号，连接“成功”但表为空
navicat 的 sqlite 驱动不解析任何路径缩写，./data.db、data/app.sqlite、~/project/db.db、$home/db.db 全部无效——它会静默跳过，假装连上了，实际根本没打开目标文件。
现象是：Tables 面板空、SELECT * FROM sqlite_master 返回空结果、新建表后重启 Navicat 就消失。
- macOS/Linux：用终端执行
realpath /path/to/your.db，复制输出结果 - Windows：在资源管理器中右键文件 → “属性” → “位置”栏全选复制，再手动拼上文件名（如
C:\Users\Alice\app\data.db） - 别从 Finder 或地址栏手输，容易漏盘符、错斜杠方向，或把
/Users/误写成C:/Users/
填了用户名或密码，连接直接失败
SQLite 是嵌入式数据库，没有认证机制。Username 和 Password 字段必须留空，但 Navicat 界面校验强制要求非空——填任意字符串（如 user 和 pass）能绕过校验，它们完全不参与连接过程。
填 root、admin、空格、"" 或点击 “Generate”，都会导致连接失败或行为异常。
- 确认
Database File是唯一必填项，其余字段（Initial Database、Port）全部忽略 - 如果用了 SQLCipher 加密库，Navicat 当前版本（v17.0+）不支持直连，需先用命令行解密导出为普通 SQLite 文件
连上了但看不到表，或同步时报 “锁库无法操作”
常见原因不是 Navicat 加了锁，而是 SQLite 文件被其他进程独占占用，或 WAL 模式残留导致驱动加载失败。
WAL 模式下，Navicat 旧驱动对 .db-wal 和 .db-shm 文件支持不完整，易表现为“有连接无表”“修改不生效”“同步卡死”。
- 先用命令行验证：
sqlite3 /full/path/to/your.db ".tables"能列出表，说明文件本身正常 - 查占用：macOS/Linux 执行
lsof | grep your.db；Windows 用handle.exe your.db（Sysinternals 工具） - 临时修复：
sqlite3 /full/path/to/your.db "PRAGMA journal_mode=delete;"，再删同目录下的.db-wal和.db-shm - 长期建议：团队统一禁用 WAL，脚本里避免写
PRAGMA journal_mode=WAL
报错 14 - unable to open database file
这个错误绝大多数情况就是路径不对或权限不足，不是 SQLite 版本或加密问题。
Navicat 不会告诉你“路径不存在”，而是直接报 14。尤其注意路径含中文、空格时，手动输入易被截断（如 C:\我的项目\data.db 可能只读到 C:\我的项目\data）。
- 务必用系统自带方式复制完整路径：macOS “显示简介”里的“位置”，Windows “属性”里的“位置”
- 检查文件是否真实存在：
cd /d "C:\我的项目" && dir data.db（Windows），或ls -l /path/to/your.db（macOS/Linux） - 避开受保护路径：Windows 别放
Program Files，macOS 别放 iCloud 同步目录（路径语义会变）
最常被忽略的点是：WAL 模式残留 + 其他进程未释放句柄，这两者叠加时，Navicat 表现得像“随机失败”，其实每次都是确定性地卡在文件锁和 WAL 文件校验上。
