Hexo博客
我推荐的、也是目前最主流的组合是:Hexo + GitHub Pages。
- Hexo:一个基于 Node.js 的静态博客框架。它非常受中文社区欢迎,主题(皮肤)超级多,文档也全,你写 Markdown 非常方便。
- GitHub Pages:GitHub 提供的免费静态网页托管服务。
详细步骤:从零开始搭建 Hexo + GitHub Pages 博客
你只需要跟着这几步走,就能搭建完成。
第 1 步:准备工作(安装必备软件)
在开始之前,你的电脑上需要有 Git 和 Node.js。
-
安装 Git:
-
访问 Git 官网 下载并安装。
-
安装后,打开你的终端(Windows 叫 “CMD” 或 “PowerShell”,Mac/Linux 叫 “Terminal”),输入
git --version,能看到版本号就说明装好了。
-
-
安装 Node.js:
-
访问 Node.js 官网,下载 “LTS” (长期支持) 版本并安装。
-
安装后,在终端输入
node -v和npm -v,能看到版本号就说明装好了。
-
第 2 步:在 GitHub 上创建仓库
这是你未来存放网站的地方。
-
登录你的 GitHub 账号。
-
创建一个新的、公开的 (Public) 仓库。
-
关键一步:仓库的名称必须是
你的GitHub用户名.github.io。- 例如,如果你的用户名是
zhangsan,那么仓库名就是zhangsan.github.io。
- 例如,如果你的用户名是
第 3 步:在本地安装和初始化 Hexo
-
全局安装 Hexo:
打开终端,运行以下命令:
1
npm install -g hexo-cli
-
初始化博客文件夹:
在你电脑上找一个喜欢的位置(比如 D 盘或“文稿”目录),然后在终端里 cd 过去。运行:
1
hexo init my-blog # "my-blog" 是你博客的文件夹名,可以自定义
-
进入并安装依赖:
1
2cd my-blog
npm install现在,你的博客框架已经在
my-blog文件夹里了。
第 4 步:本地预览(看你博客的样子)
Hexo 有一个本地服务器,可以让你在发布前先在自己电脑上预览。
-
在终端(必须在
my-blog目录内)运行:1
hexo server
或者简写
hexo s。 -
打开浏览器,访问
http://localhost:4000。 -
你会看到一个默认主题的 Hexo 博客。按
Ctrl + C可以关闭本地服务器。
第 5 步:写你的第一篇 Markdown 博客
-
在终端(仍在
my-blog目录)运行:1
hexo new "Hello World"
-
Hexo 会在
my-blog/source/_posts/目录下创建一个Hello-World.md文件。 -
你用任何 Markdown 编辑器(比如 VS Code, Typora)打开这个
.md文件,就可以开始写作了。
第 6 步:配置部署(让 Hexo 知道你的 GitHub 仓库)
-
安装 Git 部署插件:
在 my-blog 目录的终端中运行:
1
npm install hexo-deployer-git --save
-
修改配置文件:
打开 my-blog 文件夹根目录下的 _config.yml 文件(注意是根目录的,不是主题里的)。
-
滚到文件最底部,找到
deploy:部分,修改成这样(注意冒号后面必须有空格):1
2
3
4deploy:
type: git
repo: https://github.com/你的用户名/你的用户名.github.io.git
branch: main # 或者 master,取决于你 GitHub 仓库的默认分支是啥- 把
你的用户名替换成你自己的 GitHub 用户名。
- 把
第 7 步:一键生成和部署(发布网站)
这是最后一步。
-
生成静态文件:Hexo 会把你的 Markdown 文件转换成 HTML。
1
hexo generate
(或者简写
hexo g) -
部署到 GitHub:
1
hexo deploy
(或者简写
hexo d)这个命令会做两件事:
-
自动执行
hexo g来生成最新的静态文件。 -
把生成的网站内容(
public目录下的所有东西)推送到你第 2 步创建的your-username.github.io仓库里。
(注:第一次部署时,Git 可能会提示你输入 GitHub 的用户名和密码/Token。)
-
第 8 步:访问你的公网博客
部署成功后,等待 1-2 分钟(GitHub Pages 需要一点时间反应)。
在浏览器中访问: https://angelysss.github.io
恭喜!你现在有了一个完全免费、支持 Markdown、并且公网可访问的个人博客了。
后续维护
- 写新文章:重复第 5 步(
hexo new "文章名")和第 7 步(hexo d)。 - 换主题:如果你不喜欢默认主题,可以去 Hexo 主题官网 挑选。更换主题通常只需要下载主题文件,并在
_config.yml里改一个theme:字段的值,非常简单。 - 数据安全:你的所有博文(
.md文件)都在本地的my-blog/source/_posts文件夹里,请一定做好备份(比如单独用一个 Git 仓库来存这些源文件)。

