Database Tools and SQL 插件需启用，SQLite数据源必须用绝对路径，首次连接需下载或手动添加3.40+版sqlite-jdbc驱动，连接后若无表需检查文件锁、目录权限及驱动版本。
确认 Database Tools and SQL 插件已启用
如果 Database 工具窗口根本没出现，或点击“Create data source”无反应，大概率是插件被手动禁用了。按 Ctrl+Alt+S（Windows/Linux）或 Cmd+, （macOS）打开设置 → 进入 Plugins → 在 Installed 页签搜索 Database Tools and SQL → 确保复选框已勾选。该插件默认启用，但团队共享配置或重装后容易被关掉。
添加 SQLite 数据源时填对 File 路径
在 Database 工具窗口（View → Tool Windows → Database）点击 + → Data Source → SQLite 后，关键字段只有 File：它必须是绝对路径，不能写 db.sqlite 或 ./data/db.sqlite。相对路径会以 IDE 启动目录为基准，极易连错文件甚至新建空库。
- 推荐写法：
/Users/you/project/data/app.db（macOS/Linux）或C:\myproject\data\app.db（Windows） - 若用 PHP 项目，可直接复制
__DIR__ . '/data/app.db'中的路径部分粘贴进去 - 填完务必点
Test Connection—— 成功才说明路径可读、文件存在（或能新建）、权限正常
驱动下载失败或连接报 “No suitable driver”
PHPStorm 不自带 JDBC 驱动，首次添加 SQLite 数据源时，底部会出现 Download missing driver files 链接。必须点它，否则连接直接失败。如果网络受限导致下载卡住或超时：
PhpStorm 2026.1 Mac 版已针对 Apple Silicon（M1/M2/M3/M4）芯片进行原生优化，实现了极速启动与流畅运行。该版本不仅深度适配 Laravel 13 与 Livewire 框架，还创新性地集成了 MCP 服务器，允许开发者直接在 IDE 内调用 Claude Code 等 AI 智能体辅助编程。配合优化的索引机制与 macOS 原生界面风格，它为 Mac 用户
- 手动下载驱动：去 Maven Central 找最新版
sqlite-jdbc-*.jar - 回到数据源设置 →
Driver页签 → 点击+→ 选Custom JARs→ 添加刚下载的 JAR 文件 - 注意：不要混用旧版驱动（如 3.18.x），SQLite 3.35+ 的窗口函数、UPSERT 等特性需要 3.40+ 驱动才能正确内省
连上了却看不到表？检查内省范围和文件权限
连接测试通过，但 Database 窗口里只显示空 schema，常见原因有两个：
立即学习“PHP免费学习笔记（深入）”；
- SQLite 文件被其他进程（如 PHP 脚本、命令行
sqlite3）独占打开且未释放锁 —— 关闭所有可能访问该 DB 的程序再试 - 文件所在目录对当前用户（即运行 PhpStorm 的用户）不可写 —— 即使只读连接也需目录可执行（
x权限），否则内省元数据（sqlite_master）会失败 - 极少数情况：DB 文件是用高版本 SQLite 创建（如 3.42），而 PhpStorm 自带驱动太老，此时需手动升级 JAR
真正麻烦的不是连不上，而是连上了却操作的是另一个同名空文件——因为路径错了一级，或者用了相对路径又没注意 IDE 启动位置。每次改路径后，务必删掉疑似误建的空 .db 文件，再重新测试。
