当前位置: 首页 > 产品大全 > 超详细Hexo+Github Pages博客搭建教程 从零开始部署个人博客

超详细Hexo+Github Pages博客搭建教程 从零开始部署个人博客

超详细Hexo+Github Pages博客搭建教程 从零开始部署个人博客

搭建个人博客是展示技术能力、分享知识和记录成长的好方法。Hexo+Github Pages的组合因其免费、快速和高度可定制的特点,成为许多开发者和写作爱好者的首选。本文将带你从零开始,一步步完成Hexo博客的搭建、部署到Github Pages,并介绍基本的配置和写作流程。

一、前期准备

在开始之前,你需要准备好以下环境和账号:

1. 安装Node.js:Hexo基于Node.js,请前往Node.js官网下载并安装LTS版本。安装完成后,打开终端(Windows用户可使用PowerShell或CMD)输入以下命令检查是否安装成功:
`bash
node -v
npm -v
`
如果显示版本号,说明安装成功。

2. 安装Git:用于版本控制和部署。前往Git官网下载安装,安装后同样在终端检查:
`bash
git --version
`

  1. 注册Github账号:如果你还没有,请前往Github官网注册一个账号。

二、安装Hexo

当Node.js和Git就绪后,通过npm(Node.js包管理器)安装Hexo命令行工具:

npm install -g hexo-cli

安装完成后,可以验证是否成功:
`bash
hexo -v
`

三、初始化博客项目

1. 创建一个文件夹作为博客的根目录,例如myblog,并在终端中进入该目录:
`bash
mkdir myblog
cd myblog
`

2. 初始化Hexo项目:
`bash
hexo init
`
此命令会生成博客所需的文件结构。

3. 安装依赖包:
`bash
npm install
`

4. 启动本地服务器,预览博客:
`bash
hexo s
`
打开浏览器访问http://localhost:4000,你应该能看到默认的Hexo页面。

四、基础配置

博客的主要配置文件是根目录下的_config.yml,通常称为站点配置文件。用文本编辑器打开它,修改以下关键信息:

title: 你的博客标题
author: 你的名字
language: zh-CN  # 设置语言为中文
timezone: Asia/Shanghai
url: https://你的用户名.github.io  # 后续部署后确定

更多配置选项可以参考Hexo官方文档

五、创建Github仓库并配置部署

  1. 在Github上创建仓库
  • 登录Github,点击右上角“+”选择“New repository”。
  • 仓库名必须为你的用户名.github.io(例如,用户名为zhangsan,则仓库名为zhangsan.github.io)。
  • 选择公开(Public),然后创建仓库。
  1. 配置SSH Key(可选但推荐)
  • 如果你尚未配置SSH Key,可以按照Github官方指南生成并添加,以便安全地推送代码。

3. 安装Hexo部署插件
在博客根目录下运行:
`bash
npm install hexo-deployer-git --save
`

4. 修改站点配置文件中的部署设置
_config.yml末尾找到deploy部分,修改为:
`yaml
deploy:
type: git
repo: [email protected]:你的用户名/你的用户名.github.io.git # 或HTTPS地址
branch: main # Github默认主分支为main
`

六、写文章与生成静态文件

1. 创建新文章
`bash
hexo new "我的第一篇文章"
`
这会在source/_posts目录下生成一个Markdown文件,你可以用任何编辑器打开并编写内容。

2. 生成静态文件
`bash
hexo g # g是generate的缩写
`
此命令会将文章和主题转换为静态HTML、CSS和JavaScript文件,存放在public文件夹中。

3. 本地预览
`bash
hexo s
`
再次访问http://localhost:4000查看效果。

七、部署到Github Pages

当一切准备就绪后,执行部署命令:
`bash
hexo d
`
如果是第一次部署,可能会提示你输入Github的用户名和密码(如果使用HTTPS仓库地址)或验证SSH Key。

部署完成后,等待1-2分钟,然后在浏览器访问https://你的用户名.github.io,你的个人博客就上线了!

八、后续维护与进阶

  • 更换主题:Hexo有丰富的主题库,下载主题后,将其放在themes文件夹中,并在</em>config.yml中修改theme配置项即可。
  • 自定义域名:如果你想使用自己的域名(如www.example.com),可以在Github仓库的Settings > Pages中设置Custom domain,并在域名服务商处添加CNAME记录。
  • 备份与更新:建议将整个博客项目(不包括publicnode_modules)推送到Github的另一个私人仓库进行备份。当Hexo有新版本时,可以通过npm update来更新。

常见问题

  1. 部署失败:检查仓库名是否正确,网络是否通畅,以及SSH Key或密码是否正确。
  2. 页面404:首次部署可能需要等待几分钟才能生效,或者检查仓库的Pages设置是否正确启用了main分支。
  3. 本地更改未生效:尝试清理缓存后重新生成:hexo clean && hexo g

现在,你已经拥有了一个快速、免费且完全由自己掌控的博客。开始写作吧,享受分享的乐趣!

如若转载,请注明出处:http://www.mylive.net/product/248.html

更新时间:2025-12-14 19:29:45