如何使用Hexo搭建个人博客

前言

Hexo是一个快速、简洁且高效的博客框架。Hexo使用Markdown（或其他语言）来写作，可以方便地与GitHub Pages集成。Hexo支持丰富的插件，可以让你快速搭建个性化的博客。

本教程将介绍如何使用Hexo搭建个人博客，并详细介绍Hexo的基本使用方法。

安装Hexo

首先，你需要安装Node.js。你可以到官方网站下载安装包安装Node.js。

或者使用Scoop安装：

1
scoop install versions/nodejs22

安装好Node.js后，cd到blog文件夹，然后你可以使用npm安装Hexo：

1
npm install -g hexo-cli

创建博客

创建博客的命令是：

1
hexo init <folder>

其中，<folder>是你要创建的博客的文件夹名称。

例如，如果你要创建名为blog的博客，则命令为：

1
hexo init blog

安装主题

Hexo提供了丰富的主题，你可以在这里找到你喜欢的主题。

安装主题的命令是：

1
2
cd <folder>
npm install hexo-theme-xxx

例如，如果你要安装名为landscape的主题，则命令为：

1
2
cd blog
npm install hexo-theme-landscape

启动博客

启动博客的命令是：

1
hexo server

Hexo会启动一个本地服务器，你可以在浏览器中访问http://localhost:4000查看博客。

写文章

在博客文件夹的source/_posts文件夹中，你可以创建新的Markdown文件，来写你的文章。

相关的命令

  • hexo new "postName"：创建一个新的文章。
  • hexo generate：将文章转换为静态页面。
  • hexo deploy：将静态页面部署到GitHub Pages。
  • hexo help：查看Hexo的所有命令。

部署到GitHub Pages

如果你想将博客部署到GitHub Pages，你需要先在GitHub上创建一个<你的用户名>.github.io的仓库。

新建Blog仓库放你的博客源代码可私有或者公有。

进入博客文件夹，配置其_config.yml，找到 url 配置项，修改为你的仓库地址。

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

或者

1
url: git@github.com:<你的用户名>/<你的用户名>.github.io.git

这里使用SSH方式，需要先配置好SSH。

1
ssh-keygen -t rsa -b 4096 -C "<你的邮箱>"

然后将生成的公钥添加到GitHub的SSH和GPG keys中。

1
cat ~/.ssh/id_rsa.pub

然后验证你是否链接到了GitHub。要使用Git bash或WSL2，运行以下命令：

bash
1
ssh -T git@github.com

成功的话Hi <你的用户名>! You’ve successfully authenticated, but GitHub does not provide shell access.

如果报这个错误2024-12-20 16:27:46.471 [info] > git clone ssh://git@ssh.github.com:443/<你的用户名>/<你的用户名>.github.io.git d:\vscode_works<你的用户名>.github.io –progress [10472ms]
2024-12-20 16:27:46.471 [info] Cloning into ‘d:\vscode_works<你的用户名>.github.io’…
Host key verification failed.
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

你需要尝试手动添加GitHub 公钥

  1. 打开 Git Bash 或命令行工具，运行以下命令，将 GitHub 的 SSH 公钥添加到 known_hosts 文件中：
1
ssh-keyscan github.com >> C:\Users\ASUS\.ssh\known_hosts
  1. 确认 known_hosts 文件已存在
  • 确保 C:\Users\ASUS\.ssh\known_hosts 文件存在，并且可以写入。
  • 如果该文件不存在，请手动创建它。
  1. 验证 SSH 密钥是否添加成功

确保你的 SSH 密钥已经正确配置，并且 GitHub 上已经添加了你的公钥。

  1. 检查本地 SSH 密钥是否正确配置：
    使用以下命令查看当前是否已加载 SSH 密钥：
1
ssh-add -L

如果没有输出或没有显示你应该用来连接 GitHub 的密钥，你可以通过以下命令添加：

1
ssh-add ~/.ssh/id_rsa

  1. 确保 SSH 公钥已添加到 GitHub
    登录 GitHub，进入 Settings -> SSH and GPG keys，确认你本地的公钥已经添加到 GitHub。

  2. 尝试使用正确的 SSH URL
    确保你正在使用正确的 SSH URL 克隆仓库。尝试以下命令：

1
git clone git@github.com:<你的用户名>/<你的用户名>.github.io.git

部署到GitHub

  1. 确保安装了
1
npm install hexo-deployer-git --save
  1. 编辑 _config.yml
1
2
3
4
deploy:
  type: git
  repo: git@github.com:<你的用户名>/<你的用户名>.github.io.git
  branch: main

或者不使用SSH

1
2
3
4
deploy:
  type: git
  repo: https://github.com/<你的用户名>/<你的用户名>.github.io.git
  branch: main
  1. 部署博客

在blog文件夹下，运行以下命令：

1
2
3
hexo generate 
or
hexo g
1
2
3
hexo deploy
or 
hexo d

部署完成后，你应该可以访问你的博客了。