Hugo 是使用Go语言 编写的，支持多个平台。 最新版本见 Hugo 分发版本.

当前，Hugo对下列系统提供了预编译的二进制文件:

  • macOS (Darwin) for x64, i386, and ARM architectures
  • Windows
  • Linux
  • OpenBSD
  • FreeBSD

本文仅讨论在Windows系统上安装Hugo过程

快速安装

二进制安装 (跨平台)

从[Hugo版本]处下载适合您系统的版本。下载以后，二进制文件可以在任何目录运行。不需要安装在全局目录。这在共享主机或者您没有特权账户的系统上变现良好。

Chocolatey (Windows)

在windows系统中使用Chocolatey管理包，使用下面命令安装Hugo:

1

choco install hugo -confirm

或者使用下面命令下载包含 Sass/SCSS 处理能力的hugo-extended扩展版本:

1

choco install hugo-extended -confirm

Scoop (Windows)

在windows系统中使用Scoop管理包，使用下面命令安装Hugo:

1

scoop install hugo

或者通过下面命令下载hugo-extended 扩展版本:

1

scoop install hugo-extended

Windows系统

下面视频旨在成为在Windows PC上安装Hugo的完整指导

假设

  1. 您使用 C:\Hugo\Sites 目录作为新项目的起始点.
  2. 您使用 C:\Hugo\bin目录作为存储hugo可执行文件的目录

配置目录

您需要存储Hugo可执行文件，content和产生的Hugo站点文件的目录:

  1. 打开Windows 浏览器
  2. 创建 C:\Hugo目录, 假设您想Hugo置于您的C盘，当然可以在任何地方
  3. 在Hugo目录下创建子目录: C:\Hugo\bin
  4. 在Hugo目录下创建另一个子目录: C:\Hugo\Sites

技术用户

  1. 从Hugo Releases下载最新的Hugo可执行性文件压缩包.
  2. 解压缩所有内容到你的 ..\Hugo\bin 目录.
  3. 在 PowerShell 或者您喜欢的命令行洁面中, 跳转目录到C:\Hugo\bin, 运行命令 set PATH=%PATH%;C:\Hugo\bin将 C:\Hugo\bin(或者您hugo.exe文件所在位置), 将hugo.exe 可执行文件添加到您的系统变量中。如果重新启动后，hugo不起作用，您可能需要作为系统管理员来运行这个命令。

非技术用户

  1. 打开浏览器转至 Hugo发布版本 页面.
  2. 最新的版本在网页上面, 滚动到版本发布信息的底部下载链接部分, 都是ZIP文件
  3. 找到windows文件在底部附近(按字母顺序，所以windows在后面), 根据你的操作系统是32位还是64位选择相应的32位或者64位发布版本。(如果不清楚自己系统位数, 请看这里.)
  4. 下载好文件后, 将压缩文件移动到您的 C:\Hugo\bin 目录.
  5. 双击ZIP文件解压缩，确保解压缩文件放在相同的 C:\Hugo\bin目录-windows默认会这样做, 除非您会选择其他地方解压缩文件
  6. 现在您应该有下面三个文件: hugo可执行文件 (hugo.exe)、许可LICENSE 和自述文件README.md.

接下来您需要将Hugo添加到Windows的路径环境变量设置中:

Windows 10用户设置方法:

  • 右键点击 开始 按钮.
  • 点击 系统.
  • 点击左侧 高级系统设置.
  • 点击底部 环境变量… 按钮
  • 在用户变量部分, 找到以大写字母PATH开头的那行.
  • 双击PATH.
  • 点击 新建… 按钮
  • 在目录输入框中输入 hugo.exe 的解压缩目录, 也就是 C:\Hugo\bin, 如果您是按照上面的指示安装的。这个环境变量是Hugo所在的目录而不是二进制文件本身. 输入完毕 按 Enter 键.
  • 在每个窗口点击OK退出设置.
Path Editor in Windows 10

Windows 10的 路径编辑器是在大约2015年11月更新中添加的。您系统内应该有这个或者以后的更新, 上面步骤才会工作。您可以通过点击 Start button → Settings → System → About来查看自己的Windows 10版本。也请参考这里获得更新信息。

Windows 7 和 8.x 用户:

Windows 7和8.1没有包换Windows 10中包含的简单的路径环境变量编辑器, 建议这些系统的非技术用户安装免费的第三方路径变量编辑器,比如like Windows Environment Variables Editor 或者Path Editor ).

验证可执行文件 Verify the Executable

运行几个命令确认可执行文件已经就绪，然后从构建一个例子站点开始.

1. 打开命令提示符

在提示符界面，输入hugo help 然后按Enter 键。会看见如下面这样开始的输出:

1
2
3
4
5
6

hugo is the main command, used to build your Hugo site.

Hugo is a Fast and Flexible Static Site Generator
built with love by spf13 and friends in Go.

Complete documentation is available at https://gohugo.io/.

如果看见这样的输出, 恭喜！安装已经完成了。如果没有看见，那么仔细检查在环境变量中输入的是正确的hugo.exe文件所在的目录。 如果还是没有正确，请查询Hugo discussion forum，看看是否有其他人已经解决了我们的文同。如果还没有，在"support"类目下留个note-请确保包含您的命令 和 您的输出。

At the prompt, change your directory to the Sites directory. 在命令行，变化目录到您的站点Sites目录

1
2

C:\Program Files> cd C:\Hugo\Sites
C:\Hugo\Sites>

2. 运行命令

运行命令生成新站点，此处使用了example.com作为站点的名字

1

C:\Hugo\Sites> hugo new site example.com

现在您应该看见目录C:\Hugo\Sites\example.com。 进入目录，列表显示内容。会看见同下面类似的输出:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

C:\Hugo\Sites> cd example.com
C:\Hugo\Sites\example.com> dir
Directory of C:\hugo\sites\example.com

04/13/2015  10:44 PM    <DIR>          .
04/13/2015  10:44 PM    <DIR>          ..
04/13/2015  10:44 PM    <DIR>          archetypes
04/13/2015  10:44 PM                83 config.toml
04/13/2015  10:44 PM    <DIR>          content
04/13/2015  10:44 PM    <DIR>          data
04/13/2015  10:44 PM    <DIR>          layouts
04/13/2015  10:44 PM    <DIR>          static
               1 File(s)             83 bytes
               7 Dir(s)   6,273,331,200 bytes free

Windows安装故障解决

@dhersam 创建了常见问题解决方案的视频(英语):

后续

现在已经安装Hugo，接下来可以阅读快速开始文档, 探索文档的其余部分。 如果有问题请访问 Hugo Discussion Forum访问Hugo社区咨询。