Navicat 连接 SQLite 必须使用操作系统原生绝对路径，Windows 以盘符开头（如 C:\dev\myapp\data.db），macOS/Linux 以斜杠开头（如 /Users/alex/project/cache.db），相对路径、波浪号、环境变量均无效且静默失败。
navicat 连接 sqlite 必须用绝对路径，跨平台时路径写法、斜杠方向、波浪号（~）和环境变量全部无效——填错就静默失败，不是报错。
Windows 和 macOS/Linux 的绝对路径写法差异
Navicat 的 SQLite 驱动直接把路径字符串传给 sqlite3_open_v2()，该函数不解析任何路径缩写，只认操作系统原生可定位的绝对路径。
- Windows 正确示例：
C:\dev\myapp\data.db（反斜杠或正斜杠均可，Navicat 内部会标准化） - macOS/Linux 正确示例：
/Users/alex/project/cache.db（必须以/开头） - 全部错误写法：
./data.db、data/app.sqlite、~/Documents/test.db、$HOME/project/db.db - 后果：连接“成功”，但 Tables 面板为空，
SELECT * FROM sqlite_master返回空结果——实际根本没打开目标文件
路径含空格或中文时怎么避免截断？
Navicat 内部路径处理链是 Qt QString → sqlite C API → OS open()，中间未加引号会导致空格或中文后半段被丢弃。比如 C:\我的项目\data.db 可能只读到 C:\我的项目\data。
- 推荐做法：在文件管理器中右键 → “属性”（Windows）或“显示简介”（macOS），复制“位置”字段里的完整路径，再手动拼上文件名
- 终端验证（macOS/Linux）：
realpath /path/to/your.db；Windows 命令行用cd /d "C:\我的项目" && dir data.db确认存在 - 避免用 Finder 或资源管理器地址栏手动输入，容易输错斜杠方向或漏掉盘符/根目录
为什么 Navicat 连接后看不到表，且改了也“消失”？
常见于跨平台协作场景：开发机是 macOS，部署机是 Linux，但 SQLite 文件被同步到 iCloud 或 NAS 后路径语义已变，或 WAL 模式残留导致 Navicat 加载失败。
- 先排除文件占用：
lsof | grep your.db（macOS/Linux）或handle.exe your.db（Windows）查谁锁着文件 - WAL 模式兼容性差：Navicat 旧驱动对
.db-wal和.db-shm文件支持不完整，易表现为“有连接无表” - 临时修复：
sqlite3 /full/path/to/your.db "PRAGMA journal_mode=delete;"，再删同目录下.db-wal和.db-shm - 长期建议：团队统一用 DELETE 模式，避免在脚本里写
PRAGMA journal_mode=WAL
HTTP 通道远程访问不是跨平台“路径问题”的解法
有人想用 ntunnel_sqlite.php 绕过本地路径限制，但这是另一套机制：它依赖服务器端 PHP 环境 + 正确的相对路径（相对于 ntunnel_sqlite.php 文件位置），和 Navicat 本地连接的路径规则完全无关。
- 服务端路径填的是
test.db（同目录）或../data/app.db（上级目录），不是绝对路径 - 客户端 Navicat 里填的仍是这个相对路径，不是你本地磁盘路径
- 本质是把 SQLite 操作代理到远端 PHP 执行，不是 Navicat 直连——别混淆“跨平台开发”和“远程访问”两个需求
最易被忽略的一点：路径正确 ≠ 权限可用。macOS 上 iCloud 同步目录、Windows 上 Program Files 或 OneDrive 自动加密目录，Navicat 可能有读权限但无 mmap 权限，导致打开失败却无明确提示。务必把 .db 放在用户主目录下的普通子目录里，例如 /Users/you/dev/myapp/data.db 或 C:\Users\you\dev\myapp\data.db。
