如需从命令行连接到 AlloyDB for PostgreSQL 实例，您可以在 macOS、Linux 或 Windows 上安装 psql 客户端工具。psql 命令行工具是 PostgreSQL 的基于终端的前端，gcloud beta alloydb connect 命令需要该工具，并且该工具也用于直接数据库连接。
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 客户端工具的版本。