如何将 Hexo 部署到 GitHub Pages

引言

在数字时代,拥有个人博客是展示自己想法、分享知识和技能的绝佳方式。Hexo 是一个基于 Node.js 的静态博客生成器,它结合了简洁性和功能性,让我们可以轻松地建立并维护一个博客。而 GitHub Pages 提供了一个免费的平台来托管这些静态网站,这使得 Hexo 成为了许多开发者和技术写作者的首选工具。

准备工作

在开始之前,你需要确保以下条件都满足:

  • 已经安装了 Node.js npm
  • 安装了 Git

如何用Hexo搭建一个优雅的博客

部署

新建仓库

创建一个和你用户名相同的仓库,后面加.github.io,只有这样,将来要部署到GitHub page的时候,才会被识别

假如我没有用lnoom.github.io而是用了yu.github.io,那么当我浏览器访问博客的时候会出现404错误。这里并不是没有部署成功,而是把它部署在了这里:http://lnoom.github.io/yu.github.io。所以,如果想直接lnoom.github.io访问,那么就需要和用户名保持一致。

设置公钥

查看本地公钥

添加密匙

克隆仓库网址

部署到 GitHub Pages

在 _config.yml 文件中,找到 deploy 部分,并配置你的仓库:

shell 复制代码
deploy:
    type: git
    repo: git@github.com:lnoom/lnoom.github.io.git 
    branch: master

清理静态文件

bash 复制代码
hexo clean 删除public静态文件以及缓存

项目部署

shell 复制代码
#hexo generate 该命令可以简写为:hexo d 生成静态文件
#hexo deploy 该命令可以简写为:hexo d 部署网站
hexo g -d

查看远程创库

查看域名

访问

结语

恭喜你!现在你已经成功将你的Hexo博客部署到了 GitHub Pages。你的博客现在应该可以通过你设置的 URL 访问了。HexoGitHub Pages 的结合提供了一个强大、灵活且免费的平台来建立和分享你的知识。


记得,持续创作是博客成功的关键。祝你在博客旅程中一切顺利!

相关推荐
lpfasd12318 小时前
2026年第38周GitHub趋势周报
python·科技·github
u13013019 小时前
GitHub 热榜项目:日榜(2026-09-21)
人工智能·github
张洛闻Eren20 小时前
k8s云原生【第十课】:水平 Pod 自动扩缩容
运维·数据库·云原生·kubernetes·github
m4Rk_21 小时前
【论文阅读】Agent 记忆机制(77):TSM——让记忆回到事件真正发生的时间
论文阅读·人工智能·学习·开源·github
橘和柠21 小时前
依赖冲突:装个包装崩了项目,怎么排查和救回来
github
别动我齐刘海1 天前
ROS2 Jazzy + C++ 实战路线——ros2_control
c++·人工智能·python·opencv·机器学习·机器人·github
怕浪猫1 天前
ZCode 开源了来看看这是个什么东西
node.js·github·代码规范
demo007x1 天前
我用 AI 做了一个跨平台的PopClip:拾趣Magpie
程序员·github·ai编程
miofly1 天前
GitHub 日榜趋势速报 | 2026-09-22
开源·github