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


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

相关推荐
MicrosoftReactor1 小时前
技术速递|在 GitHub Copilot App 中渲染超大型拉取请求
ai·github·copilot·虚拟化·拉取请求
miofly2 小时前
Gemini 4 Carbon发布:安全基准领先,幻觉率升至11%
开源·github
科小怪3 小时前
万能文件格式转换器Filee下载安装全流程图解:255种格式离线转,不用装Office(2026最新)
github·格式转换·软件推荐·下载教程
徐小夕3 小时前
扒了JitWord的源码,我终于搞懂了企业级在线Word到底有多难写
前端·vue.js·github
miofly5 小时前
GitHub 日榜趋势速报 | 2026-10-29
开源·github
u13013017 小时前
GitHub 热榜项目:日榜(2026-10-27)
人工智能·github
zroooo17 小时前
GitHub Flow
github
粥里有勺糖18 小时前
视野修炼-技术周刊第137期 | 编程已经面目全非
前端·github·ai编程
miofly18 小时前
GitHub 今日推荐|rea:用 MCP 把反编译器和 AI agent 接到一起的逆向工具
typescript·开源·github
MicrosoftReactor19 小时前
技术速递|超越一刀切:为 GitHub Copilot CLI 和 VS Code 实现决策路由
vscode·ai·github·copilot·决策路由