GDAL、GRASS、SAGA 怎麼啟用
處理工具箱的提供者設定
照著舊教學要做「SAGA 的坡度」或「GRASS 的 r.watershed」,打開處理工具箱卻找不到那一組工具;或是工具找得到,一執行就報「找不到程式」。水保、地質、水文常用的地形與水文演算法很多來自 GRASS 和 SAGA,提供者沒設好,M3、M4、M5 的單元都做不下去。
- 已安裝的 QGIS(見 01 安裝 QGIS 4)
- 若要用 SAGA:另外安裝的 SAGA GIS(從 SAGA 官方下載頁或 OSGeo4W 安裝),以及 Processing Saga NextGen Provider 外掛
- 一份小的 DEM 測試資料,例如從政府資料開放平臺下載的數值地形模型,用來試跑演算法
操作步驟(QGIS 4)
Section titled “操作步驟(QGIS 4)”-
開啟 處理 Processing ▸ 工具箱 Toolbox,看清單裡有哪些提供者群組(例如 GDAL、GRASS、QGIS 原生演算法)。
-
到 設定 Settings ▸ 選項 Options ▸ 處理 Processing,展開 提供者 Providers。每個提供者都有「啟用」勾選與各自的設定項。
-
GDAL:隨 QGIS 安裝,通常不需設定。確認已勾選啟用即可。
-
GRASS:
- Windows 的獨立安裝檔會自動設定 GRASS;用 OSGeo4W 安裝時,要在安裝程式裡勾選 GRASS。
- 只有 Windows 使用者可能需要指定 GRASS 資料夾;預設使用隨 QGIS 附帶的 GRASS。
- 啟用後,工具箱會出現 GRASS 群組,演算法名稱以
r.、v.開頭。
-
SAGA:
- 先安裝 SAGA GIS 本體,記下安裝(或解壓縮)的資料夾。
- 安裝 Processing Saga NextGen Provider 外掛(安裝方式見 04 外掛管理員)。
- 回到提供者設定,在 SAGA 的項目中指定 SAGA 資料夾。
- 工具箱出現 SAGA 群組後,挑一個簡單演算法用測試 DEM 試跑。
-
試跑任一演算法時,看「記錄 Log」分頁:外部程式的實際呼叫指令與錯誤訊息都在這裡。
提供者是什麼
Section titled “提供者是什麼”處理工具箱本身只是一個統一的介面。真正執行運算的是各個「提供者」(provider):
| 提供者 | 運算由誰執行 | 安裝方式 |
|---|---|---|
| QGIS 原生(native) | QGIS 本身的 C++ 程式 | 內建 |
| GDAL | GDAL 函式庫與命令列工具 | 隨 QGIS 安裝 |
| GRASS | GRASS GIS 的模組,QGIS 在背景啟動一個暫時的 GRASS 工作區執行 | 隨 Windows 安裝檔附帶,或 OSGeo4W 勾選 |
| SAGA | SAGA GIS 的命令列程式 saga_cmd |
自 3.30 起需另裝 SAGA 本體+外掛 |
外部提供者(GRASS、SAGA)每次執行,QGIS 都要把輸入圖層寫成暫存檔、呼叫外部程式、再讀回結果。所以:
- 同一個運算,外部提供者通常比原生演算法多一段讀寫時間。
- 中文路徑、空白、太長的路徑,比較容易在外部程式端出問題。
- 出錯時,錯誤訊息常來自外部程式本身,要看記錄分頁才知道原因。
SAGA 為什麼不見了
Section titled “SAGA 為什麼不見了”SAGA 原本內建在 QGIS。QGIS 開發者在 GitHub 議題 #51041 說明:內建的 SAGA 工具在 3.30 已完全移除,原因是那套提供者已無人維護、也無法配合新版 SAGA。之後改由第三方外掛 Processing Saga NextGen Provider 提供,外掛說明寫明「僅在 SAGA 9.2、9.12 測試過」,且必須另外安裝 SAGA 本體。
這代表兩件事:
- SAGA 的演算法名稱、參數,可能和舊教學(3.28 以前)的內建版不同,因為對應的是新版 SAGA。
- SAGA 的可用性取決於外掛有沒有人維護。報告或 SOP 若寫死「用 SAGA 某工具」,應同時記下 GRASS 或原生演算法的替代做法。
選哪個提供者
Section titled “選哪個提供者”同一種分析常有多個提供者都能做(例如坡度:原生、GDAL、GRASS、SAGA 都有)。選擇原則:
- 先用原生或 GDAL:不需外部程式,同事的電腦也一定有。
- 需要特定方法才用 GRASS/SAGA:例如指定的流向演算法、特定的地形指數。
- 交付報告時寫清楚:提供者名稱與演算法 ID,不同提供者的同名工具算法可能不同,結果會有差異。
| 症狀 | 原因 | 解法 |
|---|---|---|
| 工具箱沒有 SAGA 群組 | 3.30 起 SAGA 不再內建 | 安裝 SAGA 本體與 SAGA NextGen 外掛;外掛不可用時改用 GRASS 或原生演算法 |
| SAGA 演算法一執行就失敗 | 提供者設定中的 SAGA 資料夾未指定或指錯 | 在提供者設定指定含 saga_cmd 的資料夾 |
| GRASS 演算法報錯,訊息看不懂 | 輸入路徑含中文或空白、輸出格式不被支援 | 把資料放到短的英文路徑,輸出改為 GeoTIFF 或 GeoPackage 再試 |
| 舊教學的演算法名稱找不到 | 演算法改名,或屬於已移除的提供者 | 在工具箱搜尋框用英文關鍵字(如 slope)搜尋 |

- 打開處理工具箱,列出你的 QGIS 有哪些提供者群組。
- 檢查方式:至少應有 QGIS 原生與 GDAL;Windows 獨立安裝檔通常也有 GRASS。
- 對同一份 DEM,分別用原生演算法與 GDAL 的坡度工具計算坡度,比較兩個結果。
- 檢查方式:用 點擊識別 Identify Features 在同一點查值,記下差異與兩者的參數差別(例如比例、邊緣處理)。
- 在工具箱執行任一 GRASS 演算法後,打開記錄分頁,找出 QGIS 實際呼叫的指令。
- 檢查方式:記錄中看得到 GRASS 模組名稱(如
r.slope.aspect)與暫存檔路徑。
- 檢查方式:記錄中看得到 GRASS 模組名稱(如
- Configuring external applications(QGIS 使用手冊):提供者設定位置、GRASS 路徑
- Processing Saga NextGen Provider 外掛頁:支援的 SAGA 版本、需另裝 SAGA
- QGIS GitHub 議題 #51041:內建 SAGA 在 3.30 移除的說明
- QGIS 開發者郵件論壇:SAGA GIS plugin maintenance(2026-07):外掛維護現況與 QGIS 4 分支