在数字时代,拥有一个个人博客是展示技术、分享知识和记录生活的好方法。使用Node.js、Hexo静态博客框架和GitHub Pages服务,你可以免费、快速且灵活地搭建一个属于自己的博客网站。本文将详细介绍从零开始搭建博客的完整步骤。
一、准备工作
在开始之前,你需要准备好以下几样东西:
- 安装Node.js和npm:Hexo基于Node.js,因此首先需要访问Node.js官网下载并安装最新稳定版。安装Node.js时会自动包含npm(Node包管理器)。安装完成后,可以在命令行输入
node -v和npm -v来验证安装是否成功。 - 安装Git:用于版本控制和将博客部署到GitHub。从Git官网下载并安装。安装后,同样可以使用
git --version命令检查。 - 注册GitHub账号:如果你还没有,请前往GitHub官网注册一个免费账号。
二、安装并初始化Hexo
打开命令行(终端),执行以下命令全局安装Hexo命令行工具:`bash
npm install -g hexo-cli`
安装完成后,选择一个你喜欢的目录(例如 D:\MyBlog),在该目录下初始化你的博客项目:`bash
hexo init myBlog # myBlog是你的博客文件夹名
cd myBlog
npm install # 安装依赖包`
此时,一个基本的Hexo博客就生成了。你可以运行 hexo server(或简写 hexo s)启动本地服务器,然后在浏览器中访问 http://localhost:4000 查看默认的博客效果。
三、配置博客基本信息
博客的核心配置文件是根目录下的 _config.yml 文件。用文本编辑器打开它,你需要修改一些关键设置:
title: 你的博客标题。subtitle: 副标题。description: 博客描述。author: 你的名字。language: 语言(如zh-CN)。url: 你的网站最终域名(可以先不修改,部署到GitHub后再设置)。
四、创建GitHub仓库并配置部署
1. 创建仓库:登录GitHub,点击右上角“+”号,选择“New repository”。仓库名必须严格遵循格式:你的用户名.github.io(例如,如果你的用户名是zhangsan,则仓库名为 zhangsan.github.io)。选择“Public”,然后点击“Create repository”。
2. 安装部署插件:在博客文件夹根目录下,运行命令安装Hexo的Git部署插件:`bash
npm install hexo-deployer-git --save`
3. 配置部署信息:再次编辑 _config.yml 文件,找到末尾的 deploy 部分,修改为:`yaml
deploy:
type: git
repo: https://github.com/你的用户名/你的用户名.github.io.git # 你的仓库HTTPS地址
branch: main # 或 master,取决于你的仓库默认分支名
message: "Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}" # 可选的提交信息`
五、撰写博文与本地测试
- 新建文章:在命令行中运行
hexo new "我的第一篇文章",Hexo会在source/_posts目录下生成一个Markdown文件。你可以用任何Markdown编辑器编辑这个文件。 - 生成静态文件:运行
hexo generate(或hexo g)将文章和主题编译成静态HTML文件。 - 本地预览:运行
hexo server,在本地4000端口预览博客,确保一切正常。
六、部署到GitHub Pages
当一切准备就绪,执行部署命令:`bash
hexo deploy # 或 hexo d`
首次部署可能会要求你输入GitHub的用户名和密码(现在通常需要使用Personal Access Token代替密码,可在GitHub设置中生成)。
部署完成后,等待大约1-2分钟,然后在浏览器中访问 https://你的用户名.github.io,你就能看到自己在线上的博客了!
七、后续维护与进阶
- 更新博客:以后每次写完新文章,只需重复
hexo clean(清理缓存)、hexo g、hexo d这个流程即可。 - 更换主题:Hexo有丰富的主题库。你可以访问Hexo官网的主题页面,选择喜欢的主题,按照其说明文档进行安装和配置。
- 绑定自定义域名:如果你有自己的域名,可以在仓库的“Settings” -> “Pages”里设置Custom domain,并在域名服务商处添加CNAME记录。
- 使用源码分支:一个更专业的做法是创建两个分支,例如用
main分支存放编译后的静态文件(用于GitHub Pages展示),用source分支存放你的Hexo源码(包括文章、主题和配置),这样便于备份和管理。
通过以上步骤,你已经成功搭建了一个快速、安全且完全由自己掌控的静态博客。尽情地书写你的想法,与世界分享吧!