以下以官方支援的安裝方式為主，PostgreSQL 版本可依官方網站目前提供的穩定版選擇。 ## 一、Windows 安裝 PostgreSQL ### 1. 下載安裝程式 前往 PostgreSQL 官方下載頁面： <https://www.postgresql.org/download/windows/> 點選 **Download the installer**，通常會導向 EDB（EnterpriseDB）提供的 Windows 安裝程式。 下載適合你的版本，例如： - Windows 64-bit - PostgreSQL 目前的穩定版本 - `.exe` 安裝檔 ### 2. 執行安裝程式 下載完成後，執行 `.exe` 檔案，依照精靈操作。 通常建議保留預設選項： 1. **Installation Directory** 安裝位置，例如： ```text C:\Program Files\PostgreSQL\17 ``` 2. **Select Components** 建議勾選： - PostgreSQL Server - pgAdmin 4 - Stack Builder - Command Line Tools 3. **Data Directory** PostgreSQL 資料儲存位置，通常可使用預設值。 4. **設定超級使用者密碼** 使用者名稱通常是： ```text postgres ``` 請設定並記住密碼。這是 PostgreSQL 的管理員密碼，不是 Windows 密碼。 5. **設定連接埠 Port** 預設是： ```text 5432 ``` 若沒有其他程式使用 5432，建議保留預設值。 6. **選擇語系 Locale** 通常可選擇： ```text Default locale ``` 完成後按下 **Install**，等待安裝結束。 ### 3. 使用 pgAdmin 4 安裝完成後，可以從開始功能表開啟： ```text pgAdmin 4 ``` 第一次使用時，可能需要設定 pgAdmin 的登入密碼。之後可以： 1. 在左側展開 **Servers** 2. 選擇 PostgreSQL 伺服器 3. 輸入安裝時設定的 `postgres` 密碼 4. 建立資料庫、資料表和使用者 ### 4. 使用命令列確認安裝 開啟 PowerShell 或命令提示字元，執行： ```powershell psql --version ``` 若顯示類似： ```text psql (PostgreSQL) 17.x ``` 代表命令列工具已安裝。 如果出現「找不到 psql」之類的訊息，可以直接使用完整路徑： ```powershell "C:\Program Files\PostgreSQL\17\bin\psql.exe" --version ``` 也可以將以下資料夾加入 Windows 的 `PATH`： ```text C:\Program Files\PostgreSQL\17\bin ``` ### 5. 連線測試 在命令提示字元輸入： ```powershell psql -U postgres -h localhost -p 5432 ``` 接著輸入安裝時設定的密碼。 成功後會進入 PostgreSQL 命令列，提示符可能為： ```text postgres=# ``` 離開方式： ```sql \q ``` --- ## 二、Mac 安裝 PostgreSQL Mac 通常有兩種常見方式： 1. 使用官方圖形化安裝程式 2. 使用 Homebrew 安裝 一般開發用途通常推薦 Homebrew；希望使用圖形介面則可選官方安裝程式或 Postgres.app。 --- ## 方法 A：使用 Homebrew 安裝 ### 1. 確認是否已安裝 Homebrew 開啟「終端機」Terminal，執行： ```bash brew --version ``` 如果顯示版本，表示已安裝 Homebrew。 如果尚未安裝，可以使用 Homebrew 官方網站提供的指令： <https://brew.sh/> 安裝完成後，重新開啟 Terminal。 ### 2. 安裝 PostgreSQL 執行： ```bash brew update brew install postgresql ``` Homebrew 會安裝目前可用的 PostgreSQL 版本。 確認版本： ```bash psql --version ``` ### 3. 啟動 PostgreSQL 服務 使用以下指令，讓 PostgreSQL 在背景執行： ```bash brew services start postgresql ``` 查看服務狀態： ```bash brew services list ``` 停止服務： ```bash brew services stop postgresql ``` 如果只想暫時啟動，也可以使用： ```bash pg_ctl -D "$(brew --prefix)/var/postgresql@$(psql -V | awk '{print $3}' | cut -d. -f1)" start ``` 不過一般使用 `brew services start postgresql` 即可。 ### 4. 建立本機使用者與資料庫 Homebrew 安裝後，通常會使用你的 macOS 使用者名稱作為 PostgreSQL 使用者。 可以先嘗試： ```bash createdb ``` 然後連線： ```bash psql ``` 成功後，會進入 PostgreSQL 命令列。 離開方式： ```sql \q ``` 也可以查看目前使用者： ```bash psql -c "\du" ``` ### 5. 建立指定的資料庫 例如建立名為 `mydb` 的資料庫： ```bash createdb mydb ``` 連線到該資料庫： ```bash psql mydb ``` --- ## 方法 B：使用 PostgreSQL 官方 Mac 安裝程式 前往： <https://www.postgresql.org/download/macosx/> 可以選擇 EDB 提供的 macOS 安裝程式。 下載時注意 Mac 的處理器： - Apple Silicon：M1、M2、M3、M4 等 - Intel：較舊的 Intel Mac 安裝流程通常如下： 1. 下載 `.dmg` 或安裝套件 2. 執行安裝程式 3. 選擇安裝 PostgreSQL Server、pgAdmin 和命令列工具 4. 設定 `postgres` 使用者密碼 5. 保留預設 Port `5432` 6. 完成安裝 安裝後可以使用 pgAdmin，或在 Terminal 執行： ```bash psql --version ``` 連線測試： ```bash psql -U postgres -h localhost -p 5432 ``` --- ## 方法 C：使用 Postgres.app Postgres.app 是 macOS 上相當簡單的 PostgreSQL 圖形化工具： <https://postgresapp.com/> 操作方式： 1. 下載並安裝 Postgres.app 2. 將應用程式放到 `Applications` 3. 開啟 Postgres.app 4. 按下 **Initialize** 或建立新的 PostgreSQL Server 5. 伺服器啟動後，便可使用 PostgreSQL 若 Terminal 找不到 `psql`，可以將 Postgres.app 的命令列工具加入 PATH。常見設定方式為： ```bash sudo mkdir -p /etc/paths.d echo "/Applications/Postgres.app/Contents/Versions/latest/bin" | sudo tee /etc/paths.d/postgresapp ``` 重新開啟 Terminal 後確認： ```bash psql --version ``` --- ## 三、基本連線參數 不論 Windows 或 Mac，預設連線資訊通常如下： | 項目 | 預設值 | |---|---| | 主機 Host | `localhost` | | Port | `5432` | | 管理員使用者 | `postgres` | | 預設資料庫 | `postgres` | 連線範例： ```bash psql -U postgres -h localhost -p 5432 ``` 如果要連線到指定資料庫： ```bash psql -U postgres -h localhost -p 5432 -d mydb ``` --- ## 四、建立測試資料庫與資料表 進入 `psql` 後，可以執行： ```sql CREATE DATABASE testdb; ``` 切換到資料庫： ```sql \c testdb ``` 建立資料表： ```sql CREATE TABLE users ( id SERIAL PRIMARY KEY, name VARCHAR(100) NOT NULL, email VARCHAR(200) UNIQUE ); ``` 新增資料： ```sql INSERT INTO users (name, email) VALUES ('王小明', 'ming@example.com'); ``` 查詢資料： ```sql SELECT * FROM users; ``` 列出資料庫： ```text \l ``` 列出資料表： ```text \dt ``` 離開： ```text \q ``` --- ## 五、常見問題 ### 1. Port 5432 已被使用 可以改用其他 Port，例如： ```text 5433 ``` 之後連線時指定： ```bash psql -U postgres -h localhost -p 5433 ``` ### 2. 忘記 `postgres` 密碼 Windows 通常需要透過設定檔 `pg_hba.conf` 暫時調整驗證方式後重設密碼；Mac 則可視安裝方式使用本機使用者重新建立或修改 PostgreSQL 使用者。建議先確認安裝方式與 PostgreSQL 版本，再進行重設。 ### 3. pgAdmin 與 PostgreSQL Server 的差異 - **PostgreSQL Server**：實際執行資料庫的服務 - **psql**：命令列工具 - **pgAdmin**：圖形化管理工具 只安裝 pgAdmin 並不代表已安裝 PostgreSQL Server。一般建議至少安裝 PostgreSQL Server 和命令列工具。