Hugo在windows安装教程

爱谁谁
发布: 2025-08-18 08:06:25
原创
1028人浏览过

hugo在windows上的安装教程已经在官方文档中详细描述,详见:install hugo on windows。官方文档提供了多种工具,本文将使用winget包管理工具进行安装。winget在windows 10上的安装教程详见:winget在win10的安装。

  1. 下载Hugo

Hugo在windows安装教程

使用winget下载Hugo的指令如下:

Hugo在windows安装教程

在提示同意协议条款时,选择Y并按回车键。

Hugo在windows安装教程

接下来,Hugo安装包开始下载,这取决于您的网络速度。

Hugo在windows安装教程

安装完成!

  1. 使用Hugo创建站点

在成功安装后,您可能迫不及待地想要创建Hugo站点,但可能会遇到以下问题:

Hugo在windows安装教程

提示Hugo指令无法使用,这可能是环境变量配置的问题。首先,我们需要确认winget是否已成功安装Hugo。

  1. 确认是否已安装

Hugo在windows安装教程

使用winget search命令进行确认。

  1. 在C盘下搜索Hugo安装包

Hugo在windows安装教程

注意:此图是解压后重新搜索的结果,初始搜索时可能只找到zip包。

  1. 解压zip并运行hugo.exe

Hugo在windows安装教程

解压zip包后,获取hugo.exe的路径。

  1. 设置环境变量

找到“我的电脑”->“高级系统设置”->“环境变量”->“系统变量”中的path,并添加hugo.exe的路径。

Hugo在windows安装教程

  1. 重启shell并测试Hugo指令

Hugo在windows安装教程

重启shell后,Hugo指令应该可以正常使用了。

2.x 重新回到Hugo建立站点

Hugo在windows安装教程

使用hugo new site命令在指定路径下创建站点。

Hugo在windows安装教程

在my-hugo文件夹下会新增一些文件夹和文件。

创建站点后的命令窗口会显示三条提示,告知后续应采取的措施:

  • 选择主题
  • 新建文件内容
  • 启动Hugo服务

2.1 选择主题

访问Hugo官方主题网站(https://www.php.cn/link/5387241957e449ab627283e8fb027d76

Hugo在windows安装教程

进入主题详情页,拉到底部找到Install模块,点击链接进入安装说明。

Hugo在windows安装教程

豆包AI编程
豆包AI编程

豆包推出的AI编程助手

豆包AI编程 483
查看详情 豆包AI编程

进入PaperMod主题的GitHub页面,按照安装说明使用git clone方式下载主题(需提前安装git工具)。下载后,Hugo站点的themes文件夹中会多出一个PaperMod文件夹。

Hugo在windows安装教程

Hugo在windows安装教程

下载主题后,别忘了为站点设置主题。如果没有设置主题,直接使用

hugo serve
登录后复制
会提示找不到主题模板(一堆关于HTML的报错),启动页面会显示“404 not found”。官方文档建议在
config.yml
登录后复制
中添加主题,但我在站点目录下只找到了
hugo.toml
登录后复制
。因为Hugo支持多种配置格式文件,我尝试在已有的
hugo.toml
登录后复制
中添加主题字段。

Hugo在windows安装教程

Hugo在windows安装教程

Hugo在windows安装教程

设置完主题后,使用

hugo serve
登录后复制
就可以看到主题模板了。

2.2 新建内容

Hugo的文章创建通常在content文件夹下。我们在content下创建一个posts文件夹,专门用于发布文章,然后新建一个second.md文件。

Hugo在windows安装教程

Hugo在windows安装教程

2.3 启动服务

在站点目录下,使用

hugo serve
登录后复制
启动内置服务预览博客。

Hugo在windows安装教程

Hugo在windows安装教程

hugo serve
登录后复制
可以搭配一些参数使用,常用的有:

  • --watch
    登录后复制
    :在修改文件后自动刷新浏览器
  • --buildDrafts
    登录后复制
    :包括标记为草稿的内容。
  • --theme
    登录后复制
    :指定主题。

小彩蛋:关于

localhost:1313
登录后复制
的解释。
localhost:1313
登录后复制
是一个本机地址(也可以用127.0.0.1)加上端口号1313,启动的是本地调试服务,外网无法访问。

Hugo在windows安装教程

服务地址的根目录是

hugo站点目录/content
登录后复制
文件夹。了解这层关系后,您可以根据
content
登录后复制
文件夹的目录结构映射
localhost:1313
登录后复制
的链接路径。例如,要访问about.md文件,输入
localhost:1313/about
登录后复制

Hugo在windows安装教程

2.4 生成静态网站

前面都是Hugo预览,接下来我们要生成静态网站。直接使用

hugo
登录后复制
指令,即可在
my-hugo/public
登录后复制
文件夹下生成静态网站的相关内容。

Hugo在windows安装教程

Hugo在windows安装教程

如果您有服务器,直接将public文件夹中的内容复制到服务器站点根目录即可。

结语

Hugo在Windows上的安装和本地使用就介绍到这里。这只是起步,大家建博客是为了放到互联网上供大家浏览。所以下一篇我们将讲述如何创建一个“真正”的博客。

参考文章:

  • Windows下使用hugo + github pages创建自己的个人博客
  • Hugo - 安装、设置及使用:这篇文章非常详细,也解答了我的一些疑问。主题官方文档一直建议修改
    config.yml
    登录后复制
    ,但我找了半天也没找到,直到这篇文章告诉我Hugo其实支持多种配置文件,现在默认使用的是toml格式,所以我应该按照toml格式添加
    theme
    登录后复制
    字段。

Hugo在windows安装教程

以上就是Hugo在windows安装教程的详细内容,更多请关注php中文网其它相关文章!

Windows激活工具
Windows激活工具

Windows激活工具是正版认证的激活工具,永久激活,一键解决windows许可证即将过期。可激活win7系统、win8.1系统、win10系统、win11系统。下载后先看完视频激活教程,再进行操作,100%激活成功。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号