如何将 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 的结合提供了一个强大、灵活且免费的平台来建立和分享你的知识。


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

相关推荐
逛逛GitHub7 小时前
7 个最近 GitHub 上火火火的开源项目,推荐一哈。
github
__雨夜星辰__8 小时前
什么是 Git 与 Git※hub(※Git※hub加※速访※问教程)
git·github
子夜江寒8 小时前
GitHub入门协作
github
逛逛GitHub9 小时前
一个运维人写了 12 年的开源项目,Star 刚刚破了 3 万。
github
daguanren10 小时前
LMRing 实测榜:GPT-5.4 登顶?Claude 4.6 还能打吗?
github·aigc
CoovallyAIHub10 小时前
Claude Code Review:多 Agent 自动审查 PR,代码产出翻倍后谁来把关?
算法·架构·github
happyprince13 小时前
2026年03月27日热门Model/github项目
github
司南-704915 小时前
开发自己的app之 - 如何构建自己github的release仓库
electron·github·web app
0xCode 小新15 小时前
Git常用操作
git·gitee·github
MicrosoftReactor15 小时前
技术速递|如何使用 GitHub Security Lab 的开源 AI 驱动框架进行漏洞扫描
人工智能·安全·开源·github·漏洞扫描