在 Ubuntu 上折腾 PhpStorm 数据库连接，其实不算什么难事，但如果不熟悉其中的门道，失败几次也是很正常的。下面就把整个流程拆开讲一遍，从准备工作到常见坑，一次说清楚。
一、准备与入口
- 打开数据库工具窗口的路径有两个：
View → Tool Windows → Database，或者从File → Settings/Preferences → Languages & Frameworks → PHP → Database进去。这个看个人习惯。 - 第一次点开 Database 窗口，PhpStorm 会提示下载对应的数据库驱动。没什么好犹豫的，点 Download 就行，它会自动把 MySQL 之类的驱动拉下来。
- 光有驱动还不够，本机最好也装上数据库客户端库。比如用 MySQL 的话，在终端跑一句
sudo apt-get install mysql-client，能避免很多底层驱动不兼容的问题。 - 如果目标是远程数据库，记得提前确认 Ubuntu 主机能被对方服务器允许访问。检查端口是否开放、云安全组策略是否配好——这些是网络层面的基本功。
二、新建数据源与基本参数
- 在 Database 窗口里点
+ → Data Source，然后选数据库类型，MySQL 还是 PostgreSQL 一目了然。 - 进入 General 选项卡后，需要填的内容就这几项：
- Host：本机填 localhost 或 127.0.0.1，远程填服务器的 IP。
- Port：MySQL 默认 3306，PostgreSQL 默认 5432。
- User / Password：数据库的账户和密码。
- Database：可以留空，等连上之后再选择具体库。
- 填完之后点
Test Connection，绿了就算成功，直接 OK 保存。如果红了，那就往下看排查部分。
三、常见数据库示例
- MySQL
- 驱动缺失的话，在数据源界面点 Download 就能装好。
- 典型参数：Host=localhost，Port=3306，User/Password 看你的真实配置。
- 本机没装客户端库？跑
sudo apt-get install mysql-client完事。 - 远程连接必须确保服务器放行 3306 端口，并且数据库用户的 host 权限包含你的 Ubuntu IP。
- PostgreSQL
- 数据源选 PostgreSQL，同样填 Host、Port（默认 5432）、User、Password、Database。
- 首次使用也是点 Download 安装驱动，流程和 MySQL 几乎一样。
四、连接失败排查
- 驱动问题：回到数据源界面重新点 Download 安装驱动，有时候网络波动会导致安装不完整。
- 客户端库缺失：装对应的
mysql-client或postgresql-client，跑命令就对了。 - SSL 错误：先确认数据库是否开启了 SSL。如果开了，PhpStorm 的 SSL 选项里要按实际配置证书路径或模式；如果没开，那就把 SSL 禁用掉。
- 网络与权限：Host/Port 核对清楚了吗？云数据库的安全组放行来源 IP 了吗？数据库用户的 host 字段允许从这台 Ubuntu 连接吗？这三个点最容易被忽略。
五、常用操作与效率提升
- Database 窗口里，对着表可以直接增删改查、编辑字段、执行 SQL。双击某张表就能查看和修改数据，比命令行直观多了。
- 在 Schema & Tables 里勾选需要显示的 Schema 或数据库，能避免一堆无关表干扰视线，管理起来更清爽。
- 如果需要新建数据库，直接在控制台执行
CREATE DATABASE mydb;，然后回到 Schema 列表勾选显示新库，马上就能用。
