WebStorm 2023.3 及之后版本默认捆绑并启用 Database Tools and SQL 插件,无需安装;若未显示,通常因被手动禁用或依赖条件未满足,可通过设置→Plugins→Installed 中搜索确认状态。

Database Tools and SQL 插件默认已启用,不用“安装”
WebStorm 2023.3 及之后所有版本(包括当前 2026.2)都**默认捆绑并启用 Database Tools and SQL 插件**。你不需要去 Marketplace 搜索、点击 Install、重启 IDE —— 它已经存在了。所谓“装不上”,90% 是被手动禁用了,或没注意到它依赖的底层条件没满足。
检查方式很简单:Ctrl+Alt+S(macOS 是 Cmd+,)打开设置 → 左侧选 Plugins → 切到 Installed 标签页 → 在搜索框输入 Database Tools and SQL。
- 如果复选框是勾选状态,插件已启用;
- 如果复选框灰色不可点,说明插件被锁定(极少见),重启 WebStorm 后再试;
- 如果根本搜不到该插件名,说明你用的是极老版本(
- 改完记得点右下角
Apply,否则不生效。
插件启用后仍看不到 Database 工具窗口?检查这三处
插件启用 ≠ 功能可见。常见现象是:菜单栏没有 View → Tool Windows → Database,或按 Alt+1 打不开数据库面板——这不是插件问题,而是 UI 层未触发加载。
- 先确认是否已有数据源:如果没有配置过任何数据库连接,Database 工具窗口默认不显示(不是 bug,是设计);
- 手动唤出窗口:
View → Tool Windows → Database,或直接按Alt+1(Windows/Linux)/Cmd+1(macOS); - 如果菜单项灰掉,说明插件确实没启用,回到上一节再核对;
- 如果窗口弹出但为空,且顶部有
No data sources configured提示,说明你还没创建连接 —— 这是正常起点,不是失败。
为什么点了 “Add Data Source” 却没有 MySQL/PostgreSQL 选项?
新建连接时,在 Database Tools 窗口右上角点 + → Data Source,结果列表里只有 SQLite、MongoDB 或空白?这不是插件缺失,而是驱动模板未加载。
- WebStorm 不会预装所有数据库驱动模板,首次使用某类数据库(如 MySQL)前,需先让 IDE “认识”它;
- 正确做法:点
+→Data Source→ 拉到底部选MySQL(或PostgreSQL),如果没看到,说明该驱动模板尚未初始化; - 临时解决:点
+→Driver and Data Source Setup→ 在左侧选中MySQL→ 右侧点+→Custom JARs→ 添加一个mysql-connector-j-8.0.xx.jar(哪怕只是空 JAR)→ 确认后,MySQL就会出现在新建列表里; - 本质原因:WebStorm 通过检测驱动类路径是否存在来动态渲染数据源类型菜单,没驱动 = 不显示入口。
连上数据库后表不显示、SQL 补全失效?元数据没刷出来
绿色对勾测试成功,双击数据源也展开节点,但里面空空如也,或者写 SELECT * FROM 后不提示表名 —— 这和插件无关,是元数据(schema、table、column 结构)没加载。
- 必须手动刷新:右键数据源 →
Refresh Database(或快捷键Ctrl+F5/Cmd+F5); - 刷新失败常见原因:
permission denied for schema public(PostgreSQL)、Access denied for user(MySQL 权限不足)、或用户没被授予USAGEon schema; - MySQL 用户至少需要:
GRANT SELECT ON mydb.* TO 'user'@'%'; FLUSH PRIVILEGES;; - PostgreSQL 用户至少需要:
GRANT USAGE ON SCHEMA public TO your_user; GRANT SELECT ON ALL TABLES IN SCHEMA public TO your_user;; - 如果表在非
publicschema(如myschema),进数据源设置 →Schemas标签页 → 勾选对应 schema 名再刷新。
真正卡住人的地方从来不是“怎么装插件”,而是把“插件启用”当成终点。实际流程是:启用插件 → 创建数据源 → 加载驱动 → 测试连接 → 刷新元数据 → 验证权限 → 调整事务模式。每一步都可能断在中间,而错误提示往往藏在右下角状态栏或日志里,不是弹窗报错。


















