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 记录。