快轉到主要內容

安裝 Hugo 以及其工具鏈

查看原始碼編輯此頁 (外部連結)
首次發表:

本篇說明如何在各作業系統安裝 Hugo,並設定好執行所需的環境變數(PATH)。

Hugo 版本 此標題的連結

Hugo 提供三種發行版本:

  • 無印版:基礎版本,不含 Sass/SCSS 處理功能。
  • Extended 版:多數場景建議使用的版本,內建 Sass/SCSS 編譯能力。在 v0.153.0 (外部連結) 之後已經與無印版相同。
  • Extended/Deploy 版:在 Extended 版基礎上額外整合 hugo deploy 指令,可直接部署到雲端儲存服務。

如果你沒有概念,那代表你應該安裝 Extended 版。

安裝方式 此標題的連結

你可以透過套件管理器安裝,或是手動下載 binary 檔案。正如認識 Hugo所說的,Hugo 是一個二進制執行檔,因此你可以直接下載單一檔案直接執行,兩者差異如下:

  • 套件管理器:以管理器統一管理電腦系統套件,但是需要學會如何使用管理器。有些管理器難以降版本、指定版本。
  • 二進制安裝:手動安裝,手動管理版本,稍微麻煩但是沒有任何限制。


依作業系統選擇對應的套件管理器安裝,PATH 會自動設定完成。

確認安裝成功 此標題的連結

不論用哪種方式安裝,最後都執行以下指令:

hugo version
  • 看到版本號代表安裝成功,可以繼續下一步。
  • 看到 command not found(macOS/Linux)或 不是內部或外部命令(Windows)代表 PATH 沒有設定成功,請重新開啟終端機再試一次,或是確認上方指令是否有貼錯或漏執行。

相關工具 此標題的連結

以下工具並非 Hugo 運作的必要條件,但實務上開發 Hugo 網站時經常會用到:

  • Git (外部連結):版本控制軟體,安裝主題或管理專案時使用。
  • Go (外部連結):Hugo 也支援以 Go modules 更靈活的管理專案依賴,這代表你的網站專案本身會是一個 Go module,才能使用 hugo mod 系列指令。

無障礙設定

字體大小