博客

Hexo 博客搭建过程记录 Hexo 是一个基于 Node.js 的静态博客框架，生成速度快、主题丰富、部署灵活。这篇文章记录了我从零搭建 Hexo 博客的完整过程，包括环境配置、主题选择、插件安装、自动化部署以及踩坑记录。 环境准备 安装 Node.js 与 npm Hexo 依赖 Node.js 运行，推荐使用 LTS 版本： # 确认版本 node -v # v18+ 即可 npm -v 如果网络环境受限（如国内），建议配置 npm 镜像源加速： npm config set registry https://registry.npmmirror.com 安装 Hexo CLI npm install -g hexo-cli 安装完成后就可以用 hexo 命令初始化博客项目了。 初始化博客 hexo init myblog cd myblog npm install hexo init 会自动生成博客骨架目录： myblog/ ├── _config.yml # 博客配置文件（核心） ├── package.json ├── scaffolds/ # 模板文件 ├── source/ # 源文件（文章、图片等） │ └── _posts/ # 文章目录 └── themes/ # 主题目录 核心配置 _config.yml title: 我的博客 subtitle: 记录技术与思考 author: Your Name language: zh-CN timezone: Asia/Shanghai # 域名与 URL url: https://chinazhouwy.github.io root: / permalink: :year/:month/:day/:title/ 主题选择：Hacker 在主题选择上，我倾向于简洁风。Hacker 主题颜色鲜明、排版专注，适合技术博客。 安装方式： git clone https://github.com/iissnan/hexo-theme-hacker themes/hacker 在 _config.yml 中启用： theme: hacker 主题通常有自己的独立配置文件 themes/hacker/_config.yml，可以定制导航栏、社交链接、评论系统等。 主题定制要点 导航栏：添加"首页"、“归档”、“关于"等页面 社交链接：配置 GitHub、知乎等社交账号的图标链接 评论系统：集成 Gitalk 或 Valine 等无后端评论方案 写文章与本地预览 创建新文章： hexo new "文章标题" 该命令会在 source/_posts/ 下生成一个 Markdown 文件，文件头包含 Front-matter： --- title: 文章标题 date: 2025-04-30 09:24:55 tags: - Hexo --- 本地预览： hexo server # 或指定端口 hexo server -p 4000 浏览器打开 http://localhost:4000 即可查看。 额外插件配置 自动部署插件 Hexo 生成的静态文件需要部署到服务器或 Pages 服务。最方便的方式是使用 hexo-deployer-git 插件，直接推送到 GitHub Pages： npm install hexo-deployer-git --save 在 _config.yml 中添加： deploy: type: git repo: git@github.com:chinazhouwy/chinazhouwy.github.io branch: main 部署命令： hexo clean && hexo generate && hexo deploy # 简写：hexo clean && hexo g && hexo d hexo clean：清除缓存 hexo g：生成静态文件 hexo d：部署到远端 自动摘要插件（不推荐，已关闭） npm install hexo-excerpt --save 这个插件会自动从文章正文截取摘要。但自动截取往往不够准确，不如手动在 Front-matter 中设置 excerpt 字段或使用 ` ...