psql 命令行工具是基于终端的 PostgreSQL 前端。gcloud beta alloydb
connect 命令需要此参数，并且此参数对于直接数据库连接非常有用。
PostgreSQL 具有多种安装选项。本页面介绍了如何在 macOS、Linux 和 Windows 上安装 psql。
macOS
如需在 macOS 上安装 psql，我们建议使用 Homebrew。
- 安装
postgresql软件包。
brew install postgresql
- 按照安装完成后终端输出中提供的说明，将
psql添加到PATH。例如：
echo 'export PATH="/opt/homebrew/opt/postgresql@18/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Linux（Debian / Ubuntu）
使用发行版的软件包管理器安装 PostgreSQL 客户端。
sudo apt-get update
sudo apt-get install postgresql-client
对于其他发行版，请参阅 PostgreSQL 官方下载页面。
Windows
如需在 Windows 上安装 psql，您可以使用交互式安装程序。
安装程序
- 从 PostgreSQL 下载页面下载适用于 Windows 的 PostgreSQL 交互式安装程序。
- 运行安装程序。当系统提示您选择组件时，您可以仅安装命令行工具。
- 将 PostgreSQL 安装的
bin目录（例如C:\Program Files\PostgreSQL\18\bin）添加到系统PATH环境变量中。
验证安装
安装后，验证 psql 是否位于 PATH 中，以及是否正常运行：
psql --version
如果安装正确，输出会显示 psql 客户端工具的版本。