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 用戶端工具的版本。