Hexo博客搭建

一、准备工作

  1. 首先准备一个 Github 账号(用户名.github.io留空),没有就去注册一个新账号。

  2. 安装 Git,链接: https://git-scm.com/downloads

  3. 安装 Node.js ,官网链接: Node.js — Download Node.js

安装这两个,一般都会自动配置环境,配置这个目的是可以在任何路径下使用 Git 和 Node.js,如果没有配置环境变量,可以去配置一下。

接下来,测试安装是否成功。

打开终端(Win + R,输入 cmd ,再回车),输入 node -v 如果返回了 x.x.x,说明安装成功。再输入 npm -v 如果返回了 x.x.x,说明安装成功。

这里会有一个 npm 没有 Node.js 却有的解决方案,还没写。

接着,打开 Git Bash,配置 Git 用户信息。先输入:

1
git config --global user.name "<YourName>"

其中 <YourName> 就是你的 Github 用户名。再输入:

1
git config --global user.name "<YourEmail>"

其中 <YourEmail> 就是你的 Github 绑定的邮箱。

注意:带引号!

二、开始!

注:全局使用 Git Bash

  1. 全局安装 Hexo

    1
    npm i -g hexo-cli

    需要一点时间,莫急。

  2. 创建博客项目

    先创建一个文件夹(或直接用磁盘),右键文件夹,找 Open Git Bash Here ,没有请检查 显示更多选项 或安装情况。

    再输入:

    1
    2
    3
    hexo init myblog
    cd myblog
    npm install
    1. 创建文件夹并初始化,名字自拟,推荐用这个名字,后面有问题方便查错
    2. 索引至文件夹
    3. 安装依赖
  3. 本地预览

    输入:

    1
    hexo s

    如果无法访问,尝试切换端口。

    1
    hexo s -p 5000

    其中的 5000 可以切换,默认 4000

    此时就可以看到 Hexo 自带主题了。

  4. 部署

    1. 修改文件

    修改 ~/myblog/_config.yml,在底部放上如下代码:

    1
    2
    3
    4
    5

    deploy:
    type: git
    repo: git@github.com:<YourName>/<YourName>.github.io.git
    branch: main

    注意:注意空行与缩进,还有冒号与内容间的空格。

    1. 安装部署插件

      Git Bash 里输入:

      1
      npm i hexo-deployer-git --save

      需要一点时间,莫急。等出现 ``

    2. 部署

      1. 创建仓库

        Github 上创建一个名为 <YourName>.github.io 的仓库。

      2. 部署

        Git Bash 里输入:

        1
        hexo clean && hexo g -d

        需要一点时间,莫急。

        这时有些人就会出现一些问题了,但我还没开始写。

三、进一步操作

详见 为Hexo添加数学公式渲染 & Hexo主题安装 & Hexo+Fluid美化教程


Hexo博客搭建
http://zhangyimin12345.github.io/posts/cmamfvq5t000lh836cykifp8d/
作者
zhangyimin12345
发布于
2025年5月9日
更新于
2025年5月12日
许可协议