Secco

hexo常用指令

2026-08-23T14:56:57.000Z

基础核心命令

初始化blog
1
hexo init myblog
这会创建一个名为 myblog 的目录，目录下包含博客的所有文件和目录。
安装依赖
1
npm install
这会安装博客的所有依赖，包括主题、插件等。
新建一篇文章
1
2
3
hexo new "我的第一篇文章"
或者简写为
hexo n "我的第一篇文章"
这会在创建的目录下，新建一个名为 “我的第一篇文章.md” 的文件，文件内容为默认的 Hexo 文章模板。
生成静态页面（public文件夹）
1
2
3
hexo generate
或者简写为
hexo g
这会在 public 文件夹下生成所有静态页面，包括文章、标签、分类等。
本地预览服务器
1
2
3
hexo server
或者简写为
hexo s
这会在启动一个本地服务器，你可以在浏览器中访问 http://localhost:4000 查看博客。
部署到远端
1
2
3
hexo deploy
或者简写为
hexo d
这会将本地生成的静态页面部署到远端服务器，包括 GitHub Pages、Netlify 等。

组合常用命令

生成并本地预览
1
hexo generate && hexo server
这会先生成静态页面，然后启动本地服务器，你可以在浏览器中访问 http://localhost:4000 查看博客。
生成并部署到远端
1
hexo generate && hexo deploy
这会先生成静态页面，然后部署到远端服务器，包括 GitHub Pages、Netlify 等。
清理缓存 + 生成静态页面 + 部署到远端
1
hexo clean && hexo generate && hexo deploy
这会先清理缓存，然后生成静态页面，最后部署到远端服务器。

辅助命令

清理缓存
1
2
3
hexo clean
或者简写为
hexo c
这会清理 Hexo 缓存，包括临时文件、缓存等。
草稿文章
1
hexo draft "我的草稿文章"
这会在草稿目录下，新建一个名为 “我的草稿文章.md” 的文件，文件内容为默认的 Hexo 草稿文章模板。
1
hexo publish "我的草稿文章"
这会将草稿文章发布到文章目录下，文件名与草稿文章相同。
查看版本
1
hexo -v
这会显示 Hexo 的版本号，包括 Node.js、npm、Hexo 等。
强制刷新，预览时监听文件改动
1
hexo server --watch
这会在启动本地服务器时，监听文件改动，当文件改动时，会自动刷新浏览器。

常见踩坑提示

hexo d 部署失败：检查 _config.yml 的 deploy 配置，确认安装部署插件
1
npm install hexo-deployer-git --save
页面不更新，执行
1
hexo clean
这会清理 Hexo 缓存，包括临时文件、缓存等。
本地预览失败，执行
1
hexo s -p 端口号
这会在启动本地服务器时，指定端口号，默认端口号为 4000。

个人blog部署指南

2026-08-23T14:25:28.000Z

一、安装 Node.js 和 Git

安装 Node.js

更新软件源列表
1
sudo apt update
安装 Node.js 和 npm
1
sudo apt install nodejs npm -y
安装验证
1
2
node -v
npm -v

安装 Git

安装 Git
1
sudo apt install git -y
安装验证
1
git --version

二、安装 Hexo

安装 Hexo

安装 Hexo
1
sudo npm install -g hexo-cli
安装验证
1
hexo -v

三、博客项目创建

创建博客项目, 并进入项目目录,这里以 blog 为例
1
2
mkdir blog
cd blog
初始化 Hexo 项目
1
2
hexo init .
npm install
项目验证
1
2
hexo generate
hexo server
访问 http://localhost:4000 即可查看初步搭建好的博客

四、博客项目配置

进入配置文件
1
vim _config.yml

站点基本信息设置

title: 我的技术博客          # 博客标题
subtitle: 记录学习与成长      # 副标题（部分主题显示）
description: 一个 Hexo 博客  # 博客描述（用于 SEO）
keywords: Hexo, 博客, 技术   # 关键词（用于 SEO）
author: 你的名字             # 作者名，会显示在页脚等位置
language: zh-CN             # 语言，中文填 zh-CN
timezone: Asia/Shanghai     # 时区,为空时默认使用系统时区

主题设置, 这里以 Butterfly 为例

安装 Butterfly 主题

1 2	git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly npm install hexo-renderer-pug hexo-renderer-stylus --save

配置主题
1
theme: butterfly

关闭 _config.yml 文件, 并保存
建立独立主题配置文件, 之后可在 _config.butterfly.yml 中配置主题相关参数
1
cp themes/butterfly/_config.yml _config.butterfly.yml
本地预览 Butterfly 主题博客
1
2
3
hexo clean
hexo generate
hexo server
访问 http://localhost:4000 即可查看 Butterfly 主题博客

五、博客部署到 GitHubPages

创建 GitHub 仓库

登录 GitHub 并创建一个新的仓库, 仓库名称为你的用户名.github.io
仓库设置为公开

配置 _config.yml 文件, 此处路径为 blog/_config.yml

设置网址

1	url: https://你的用户名.github.io/你的用户名.github.io

部署设置

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

配置 SSH 密钥

生成 SSH 密钥

1	ssh-keygen -t ed25519 -C "你的邮箱"

后续直接回车即可

查询并复制公钥
1
cat ~/.ssh/id_ed25519.pub
登录 GitHub 并添加公钥到 SSH 密钥对
点击设置 -> SSH 密钥对
点击添加密钥对
输入密钥对名称, 例如 blog
粘贴公钥内容
点击添加密钥对
测试 SSH 连接
1
ssh -T git@github.com
如果返回 “Hello, 你的用户名! You’ve successfully authenticated, but GitHub does not provide shell access.” 则表示配置成功

安装 Hexo 插件

1	npm install hexo-deployer-git --save-dev

部署博客
1
2
3
hexo clean
hexo generate
hexo deploy
等待 5-10 分钟即可在 https://你的用户名.github.io/你的用户名.github.io 查看部署好的博客