搭建个人博客是展示技术能力、分享知识和记录成长的好方法。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`
- 注册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仓库并配置部署
- 在Github上创建仓库:
- 登录Github,点击右上角“+”选择“New repository”。
- 仓库名必须为
你的用户名.github.io(例如,用户名为zhangsan,则仓库名为zhangsan.github.io)。
- 选择公开(Public),然后创建仓库。
- 配置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记录。
- 备份与更新:建议将整个博客项目(不包括
public和node_modules)推送到Github的另一个私人仓库进行备份。当Hexo有新版本时,可以通过npm update来更新。
常见问题
- 部署失败:检查仓库名是否正确,网络是否通畅,以及SSH Key或密码是否正确。
- 页面404:首次部署可能需要等待几分钟才能生效,或者检查仓库的Pages设置是否正确启用了main分支。
- 本地更改未生效:尝试清理缓存后重新生成:
hexo clean && hexo g。
现在,你已经拥有了一个快速、免费且完全由自己掌控的博客。开始写作吧,享受分享的乐趣!