1、Mac下使用GitHub+Hexo搭建个人博客


ceshi

一、环境准备

1.安装Homebrew

注:Linux通常使用yum或者wget安装软件,Mac电脑通常使用的brew安装三方软件,这里记录下Mac Pro下brew的安装过程。

在命令行工具输入以下命令,如果已经安装过Homebrew可以忽略。

安装命令:

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

安装过程:

image-20251003171341479

配置国内软件下载源(镜像):

image-20251003171739523

更新环境变量:

source /Users/kobe/.zprofile

image-20251003172223834

检查Homebrew是否安装成功:

输入:brew -v
输出:Homebrew 4.6.15

2.Homebrew 安装 node.js

安装命令:

brew install node

安装过程:

image-20251003172605244

安装后可以使用命令来检查是否安装成功

检查node

node -v

输出结果:

v23.11.0

检查npm是否安装成功,npm是node.js的包管理工具,用它来安装hexo

npm -v

输出结果:

10.9.2

3.Homebrew 安装git

安装命令:

brew install git

检查git是否安装成功:

git --version

输出结果:

git version 2.39.2 (Apple Git-143)

4.使用 npm 安装 hexo

安装命令:

npm install -g hexo-cli

检查hexo是否安装成功:

hexo -v

image-20251003173330995

5.卸载Homebrew

卸载命令:

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/HomebrewUninstall.sh)"

image-20251003170851593

二、创建博客

1.创建博客文件夹

mkdir ~/blog
cd ~/blog

2.用hexo初始化生成博客

hexo init

当出现Start blogging with Hexo!就代表安装完成

image-20251003173735386

3.启动博客

启动命令:

hexo s

启动成功:

image-20251003173931440

启动成功后你会得到http://localhost:4000的一个网址,用浏览器打开,你就得到了你自己的第一个博文,Hello World,

关闭的时候按 control + c 即可

HelloWorld示例:

image-20251003174421096

4.新建博客

1、输入hexo n "kobe's first blog",双引号内写博客的标题,你就可以得到一个红色的字体的一行字。
2、cd ~/blog/source/_posts/ ,在~/blog/source/_posts的目录下,可以看到博客存放位置。
3、vim kobe-s-first-blog.md,此时就可以对你的这篇博客进行编辑了。(当然后续可以在Typara或者VS Code上面下载markdown插件 提前编写好,这样后续直接上传到~/blog/source/_posts的目录下,再发布就可以了)
4、写完后再执行 hexo s,然后再访问 http://localhost:4000 就可以看见新写的文章

创建后界面显示:

image-20251003175943226

image-20251003180900725

此时每次只能在本地服务器上面执行,别人也无法访问,所以非常不方便。

因此我们要部署到GitHub上,这样别人也可以访问自己的博客。

三、将博客部署到Github

1.新建博客Git仓库

进入到自己的github,然后点右上角的加号,第一个new repository。

注意⚠️:将仓库的名字设置成自己github帐号的名字,必须一模一样,每个帐号只有一个github pages。

例如我的仓库名是kobe,那么名字必选是kobe.github.io,这是用户部署个人博客的GitHub仓库的命名要求。

2.下载git部署hexo插件

终端输入

npm install hexo-deployer-git --save

再设置:

vim _config.yml

中的最底部,设置

deploy:
  type: git
  repository: git@github.com:NicolasKevin/kobe.github.io.git
  branch: main

3.将hexo部署到github

接下来就是三部曲:

清空:hexo clean
生成:hexo g
启动:hexo d

现在你就可以通过你gtihub的名字 + .github.io来访问
比如我的博客: https://kobe.github.io/

4.hexo常用命令

Hexo常用命令
hexo new postName       #新建文章 在source/_posts 下生成     简写指令:hexo n 
hexo new page pageName  #新建页面 在source/pageName 下生成    
hexo deploy             #将.deploy目录部署到GitHub          简写指令:hexo d 
hexo generate           #生成静态页面至public目录            简写指令:hexo g 
hexo server             #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)简写指令hexo s 
hexo clean              #清除所有静态页面和缓存数据

四、配置域名

本步骤是为了配置自己的域名,如果没有可以省略。

1.申请域名

这里就不介绍了,详情百度,建议阿里云购买,腾讯云也可以

如果有域名了就不多说了。这里就直接去购买域名的地方去解析域名。

image-20220703005530661

2.pages自定义

在仓库设置,找到pages 输入自己的域名

image-20220703005810069

3.配置CNMAE文件

在本地你的博客文件夹中,找到source目录,在source目录下新建一个名为CNAME的无后缀文件(可以记事本打开,另存为所有文件),内容是你的域名(不含www),如下:

abcdxxxx.com

五、Git常用命令

5baf2af732fe1

1、克隆Github仓库到本地:

git clone https://github.com/你的用户名/你的仓库名.git
cd 你的仓库名

2、验证配置

git remote -v

此时应显示:
origin	git@github.com:NicolasKevin/kobe.github.io.git (fetch)
origin	git@github.com:NicolasKevin/kobe.github.io.git (push)

3、切换master分支

git checkout master

4、拉取最新的 master分支状态

git pull origin master

5、切换main分支

git checkout main

6、拉取最新的main分支状态

git pull origin main

7、推送main分支

git push origin main

六、常用的命令汇总

hexo init       //在指定目录执行该命令,会将当前目录初始化为hexo站点,生成hexo站点所需的一切文件
hexo new “my new blog title”   //新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 
hexo new page   //新建一个网页。生成网页后的路径会在终端中有提示
default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。
hexo clean      // 清除缓存,如果对本地文件做了修改,同步到远程验证修改的效果之前,先clean,清除缓存
hexo generate   // 可以简写成hexo g 根据markdown文件生成静态文件
hexo server     // 或者简写成hexo s 启动本地hexo 服务器,默认localhost:4000可以访问
hexo deploy     // 或者简写成hexo d 将本地修改,部署到远端
hexo version    // 显示hexo版本

Author: Kobe
Reprint policy: All articles in this blog are used except for special statements CC BY 4.0 reprint policy. If reproduced, please indicate source Kobe !
  TOC