Hexo 静态博客搭建全攻略:从零到一建立你的数字花园

Hexo 静态博客搭建全攻略:从零到一建立你的数字花园

Hexo 是一个基于 Node.js 的静态博客框架,适合追求加载速度和版本控制体验的开发者。

一、环境准备

在开始之前,请确保系统中已安装以下基础组件:

  • Git:用于版本管理和远程部署。
  • Node.js:建议使用 LTS 版本 以保证插件兼容性。
  • VS Code:用于编辑配置文件及撰写 Markdown 原稿。

二、初始化项目

选定一个空文件夹作为项目根目录,在终端执行以下操作:

# 安装全局工具
npm install hexo-cli -g

# 初始化博客程序
hexo init blog
cd blog

# 安装依赖并启动本地预览
npm install

hexo s

访问 http://localhost:4000 即可查看本地生成的初始页面。

三、主题切换

Hexo 的外观由主题决定。你可以从官方主题中心挑选,并通过 git clone 将其拉取到 themes 文件夹中。

配置生效的关键在于修改 _config.yml 站点配置文件中的 theme 字段,将其指定为对应的主题文件夹名称。

四、部署至 GitHub Pages

创建仓库:在 GitHub 新建名为 你的用户名.github.io 的公开仓库。

配置 SSH:通过 ssh-keygen 生成密钥,并将公钥添加至 GitHub 个人设置,以实现免密推送。

安装插件:在项目目录执行

npm install hexo-deployer-git --save

修改 _config.yml 末尾的部署配置:

deploy:
  type: 'git'
  repository: git@github.com:你的用户名/你的用户名.github.io.git
  branch: main

五、常用指令

日常撰写与维护主要涉及以下命令:

新建文章:

hexo new post "文章标题"

部署组合拳: 执行 hexo clean && hexo g && hexo d 来完成缓存清理、静态文件生成及云端同步。

域名绑定: 若需使用自定义域名,请在仓库设置中添加 Custom domain,并配置相应的 CNAME 记录。