说实话，我见过太多人在PG数据库面前栽跟头了。不是SQL写不出来，也不是表结构设计得多复杂，就是卡在登录这一步——明明psql就在手边，却怎么也连不上数据库。你搜遍全网，翻烂文档，发现可能就是一个参数没写对，或者压根不知道还有这么个参数。今天咱们就把PG登录这件事彻底掰开揉碎了聊，从最基础的psql命令到那些藏在角落里的连接技巧，一次性给你讲明白。
先说说最常用的psql命令。你打开终端，输入psql -U postgres，系统提示你输入密码，输完回车就进去了——这是绝大多数人第一次连接PG的方式。但你知道-U参数后面跟的是用户名，那-h参数呢？-p参数呢？很多新手以为连本机数据库不需要指定主机和端口，其实PG默认的端口是5432，如果你安装时改了端口，或者数据库跑在远程服务器上，不写-h和-p就等着报错吧。我见过最典型的错误就是psql: error: could not connect to server: Connection refused，十有八九是端口不对或者服务没起。所以别嫌麻烦，养成写全参数的习惯：psql -h 127.0.0.1 -p 5432 -U postgres -d postgres，这样至少能排除掉一半的连不上问题。
刚才说的-d参数指定数据库名，很多人忽略它。你可能会想，我不指定数据库名，直接连上去再切不行吗？行，但麻烦。PG默认会连到和你用户名同名的数据库，如果你用postgres用户登录，它会尝试连postgres数据库——这个库通常存在，但如果你用的是自定义用户，比如appuser，那PG会去找appuser这个库，找不到就直接报错。所以最稳妥的做法是登录时就明确指定要连哪个库：psql -U appuser -d myappdb。记住，PG里的数据库、用户、schema是三层不同的概念，登录时你至少得知道用户名和数据库名，否则就是瞎猫碰死耗子。
再来说说密码的问题。很多人嫌每次登录输密码麻烦，就在命令里直接写密码：psql -U postgres -d postgres -W postgres123。且慢，-W参数并不是让你在命令行传密码的，它只是提示psql交互式地询问你密码。真正想在命令行直接传密码，得用环境变量PGPASSWORD=postgres123，或者用连接串：psql postgresql://postgres:postgres123@127.0.0.1:5432/postgres。但这里我得提醒你一句，在命令行明文写密码非常危险，history里一查就全暴露了。我自己的习惯是配置.pgpass文件，把主机、端口、数据库、用户名、密码按格式写进去，权限设成600，这样psql会自动读取，既安全又省事。你要是团队协作，也可以用pghba.conf配置trust认证，但那是在测试环境才敢干的事，生产环境千万别这么玩。
说完本机登录，咱们聊聊远程连接。你公司有个PG服务器，IP是192.168.1.100，你在自己电脑上想连过去，命令其实一样：psql -h 192.168.1.100 -p 5432 -U postgres -d postgres。但这时候你大概率会遇到一个问题：FATAL: no pghba.conf entry for host "192.168.1.101", user "postgres", database "postgres"。这个报错翻译成人话就是：服务器不认你这个IP。你得去服务器上改pghba.conf文件，加一行类似host all 192.168.1.0/24 md5的配置，然后重启服务。很多人第一次弄远程连接都卡在这，以为是自己命令写错了，其实人家服务器压根没给你开门。另外注意，PG默认只监听localhost，你要是想从外面连，还得在postgresql.conf里把listenaddresses改成'*'，不然端口都是关着的。
接着说个容易让人懵的点：连接串（connection string）的写法。你可能会在文档里看到这么个东西：postgresql://user:password@host:port/dbname?sslmode=require。这玩意儿看着唬人，其实拆开就几部分：协议、用户名、密码、主机、端口、数据库名，后面还能跟一堆参数。sslmode=require就是强制SSL加密连接，这在生产环境是标配。还有个常用的参数是connecttimeout，比如postgresql://user@host/db?connecttimeout=10，意思是10秒连不上就放弃，避免卡在那儿干等。你要是用Python的psycopg2或者Node的pg库，传连接串基本都是这个格式，所以学会看懂它，比死记硬背命令重要得多。
再聊一个进阶技巧：用Unix socket连接。你在Linux服务器上操作PG，其实可以不指定-h参数，psql默认会去/tmp或者/var/run/postgresql目录找socket文件。这种方式比TCP快，因为不走网络栈，而且通常不需要密码——前提是pghba.conf里的local行配置了trust或者peer认证。peer认证的意思是，操作系统用户名就是数据库用户名，你本地是postgres用户，直接psql -U postgres就能进，连密码都不用输。很多人不知道这个，在服务器上还傻乎乎地加-h localhost，结果反而因为TCP连接要求密码而卡住。记住，本地操作优先用socket，省事又高效。
说说故障排查的思路。登录失败时，别急着改命令，先看报错信息。Connection refused说明服务没起来或者端口不对；Password authentication failed说明密码错了；FATAL: database "xxx" does not exist说明库名写错了；还有那种psql: FATAL: sorry, too many clients already，说明连接数满了。每种报错对应不同的解法，你只要把报错原文复制到搜索引擎里，基本都能找到答案。但如果你连报错都看不懂，那就先用psql --version确认工具装了没，再用pgisready -h 127.0.0.1 -p 5432检查服务通不通，一步步排查，比瞎试强得多。
回头再看这篇聊的，从最基础的psql -U到连接串、socket、pghba.conf，再到故障排查，其实PG登录没那么玄乎，核心就三件事：知道连哪个主机和端口、用哪个用户和库、以及认证方式允不允许你进。把这三点搞明白，你就能应对九成以上的登录场景。剩下的那些边角料，比如通过dblink连另一个PG实例，或者用psql的connect命令在会话里切换数据库，都是建立在基础之上的扩展。工具嘛，多用几次就熟了，但原理得先通了。下次再有人问你PG怎么登录，你可以直接把这篇甩给他，然后补一句：别瞎试，先搞清楚你要连的是什么。
