macOS

版本

Hugo 有三種版本：標準版、擴充版和擴充/部署版。雖然標準版提供核心功能，但擴充版和擴充/部署版提供進階功能。

除非您的特定部署需求需要擴充/部署版，否則我們建議使用擴充版。

先決條件

雖然在某些情況下不是必需的，但以下工具在使用 Hugo 時經常使用： Git、Go 和 Dart Sass。

Git 常用于：

• 從源代碼構建 Hugo
• 使用 Hugo 模組 功能
• 將主題作為 Git 子模組安裝
• 從本地 Git 倉庫訪問 [提交信息]
• 在诸如 CloudCannon、Cloudflare Pages、GitHub Pages、GitLab Pages 和 Netlify 等服務上托管您的網站

Go 常用于：

• 從源代碼構建 Hugo
• 使用 Hugo 模組功能

當使用 Sass 語言的最新功能時，需要 Dart Sass 將 Sass 轉譯成 CSS。

有關安裝指南，請參閱相關文檔：

• [Git][git 安裝指南]
• [Go][Go 安裝指南]
• [Dart Sass][Dart Sass 安裝指南]

預建二進位檔

預建二進位檔適用於各種作業系統和架構。請訪問 最新版本 頁面，向下滾動到「資產」部分。

1. 下載所需版本、作業系統和架構的檔案
2. 解壓縮檔案
3. 將可執行檔移動到所需目錄
4. 將此目錄新增到 PATH 環境變數中
5. 驗證您對該檔案具有「執行」權限

如果您需要設定檔案權限或修改 PATH 環境變數的協助，請參閱您的作業系統文件。

如果您沒有看到所需版本、作業系統和架構的預建二進位檔，請使用以下方法之一安裝 Hugo。

套件管理工具

Homebrew

[Homebrew] 是 macOS 和 Linux 的免費開源套件管理器。要安裝 Hugo 的擴充版：

brew install hugo

MacPorts

MacPorts 是一個免費且開源的 macOS 套件管理工具。要安裝 Hugo 的擴充版，請使用以下指令：

sudo port install hugo

從源代碼建置

要從源代碼建置擴充版或擴充/部署版，您需要：

1. 安裝 Git
2. 安裝 Go 1.20 或更高版本
3. 安裝 C 編譯器，例如 GCC 或 Clang]
4. 按照 [Go 文件] 中的說明更新您的 PATH 環境變數

安裝目錄由 GOPATH 和 GOBIN 環境變數控制。如果設置了 GOBIN，則二進位檔將安裝到該目錄。如果設置了 GOPATH，則二進位檔將安裝到 GOPATH 列表中第一個目錄的 bin 子目錄中。否則，二進位檔將安裝到默認 GOPATH ($HOME/go 或 %USERPROFILE%\go) 的 bin 子目錄中。

要建置標準版：

go install github.com/gohugoio/hugo@latest

要建置擴充版：

CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest

要建置擴充/部署版：

CGO_ENABLED=1 go install -tags extended,withdeploy github.com/gohugoio/hugo@latest

比較