搭建Hexo博客

搭建Hexo博客指南

环境准备

  • 域名：非必须，可以使用免费域名或GitHub.io/Pages.dev分配的域名。
  • GitHub账号：必须。
  • Cloudflare账号：非必须，用于将博客部署在CF的CDN里加速。

软件支持

  • Node：必须。
  • Git：必须。
  • VSCode：非必须，轻量型代码编辑器。

2.1. 安装 Node

  • 访问 Node官网 下载安装程序。
  • 安装完成后，通过 node -v 命令检查安装是否成功。
  • 修改npm源为华为云镜像源：
    1
    npm config set registry https://mirrors.huaweicloud.com/repository/npm/

2.2. 安装 Git

  • 访问 Git官网 下载适合当前系统的Git。
  • 安装后，可以通过 Git CMD、Git Bash、Git GUI 使用Git。

3. 配置Git密钥并连接至Github

  • 查看所有配置：
    1
    2
    3
    git config -l
    git config --system --list
    git config --global --list
  • 配置用户名和邮箱：
    1
    2
    git config --global user.name "你的用户名"
    git config --global user.email "你的邮箱"
  • 生成SSH公钥并添加到GitHub：
    1
    ssh-keygen -t rsa -C "你的邮箱"
  • 测试SSH连接：
    1
    ssh -T git@github.com

3.3. 创建GitHub.io仓库

  • 在GitHub上创建名为 <用户名>.github.io 的仓库。

4. 初始化Hexo博客

  • 创建博客源码文件夹，例如 D:/Hexo-Blog。
  • 在文件夹内使用 Git Bash 安装Hexo：
    1
    npm install -g hexo-cli && hexo -v
  • 初始化Hexo项目：
    1
    2
    3
    hexo init blog-demo
    cd blog-demo
    npm i

5. 将静态博客挂载到GitHub Pages

  • 安装hexo-deployer-git：
    1
    npm install hexo-deployer-git --save
  • 修改 _config.yml 文件，配置部署信息：
    1
    2
    3
    4
    deploy:
      type: git
      repository: git@github.com:<用户名>/<用户名>.github.io.git
      branch: main
  • 部署博客：
    1
    hexo clean && hexo generate && hexo deploy

6. 将静态博客挂载到Cloudflare Pages

  • 在Cloudflare Pages中连接GitHub仓库并部署。
  • 如果有自己的域名，可以在这里绑定自定义域。

如何使用

  • 新建博文：
    1
    hexo new 这是一篇新的博文
  • 本地预览：
    1
    hexo cl && hexo s
  • 发布更新：
    1
    hexo cl && hexo g && hexo d

VSCODE 终端首次执行报错

  • 使用管理员身份打开powershell，输入以下命令：
    1
    Set-ExecutionPolicy RemoteSigned

致谢项目