准备工作#

安装 Homebrew

Homebrew对于程序员来说可以说是必装的软件了，在中国大陆环境下安装需要提前设置环境变量

设置环境变量：

1
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
2
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
3
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
4
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"

直接复制到terminal ，enter

运行中科大 Homebrew 安装脚本

1
/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)"

敲两次enter，homebrew安装成功

安装 Git 和 Node.js

重新打开terminal，在terminal中输入

1
brew install git
2
brew install node

如果在安装时出现下载 缓慢 & 失败情况，请自备梯子并开启tun模式，必要时请使用全局代理

测试所需组件是否安装成功

依次输入下面的命令

1
npm -v
2
node -v
3
git --version

出现npm、Node.js和git的版本号即代表安装成功

本地部署#

安装 Hexo

在terminal中输入

1
npm install -g hexo-cli

等待安装完成后初始化博客

1
hexo init blog

在Finder/home目录下，新建一个名为blog的文件夹，并在内初始化你的博客。之后所有的操作都在这个文件夹下进行，请确保在执行后文的操作前已经切换到了这个文件夹（cd blog）

切换到blog文件夹中，即可生成和预览博客。

1
cd blog
2
hexo g
3
hexo s

执行hexo s命令后，通过浏览器访问http://127.0.0.1:4000可以预览你的博客

至此，一个简单的hexo博客就已经搭建完了，如果只是想要个本地博客，那到这就可以结束教程了，接下来将讲下怎么去部署到GitHub Pages。

部署到GitHub#

配置Git用户名和账号

1
git config --global user.name "username"
2
git config --global user.email "example@example.com"

其中 username 是你的用户名，example@example.com是你 Github 的登录邮箱。

然后通过终端命令生成 SSH Key：

1
ssh-keygen -t rsa -C "example@example.com"

执行完成后会在~/.ssh/id_rsa.pub目录下生成 需要使用的 key，也就是公钥。

到账户主文件夹下同时按Command+Shift+.显示隐藏文件，找到.ssh文件夹，打开id_rsa.pub，没有可用的编辑器就去下个VSCode，就算现在不用后面改网页也会用得到。

打开GitHub_Settings_keys 页面，新建New SSH Key，Title随意填，Key就把刚才复制的内容全都粘贴上去。然后点Add SSH Key即可。Key type不用管，默认即可

新增成功后，在终端用下面的命令试下成功没有

1
ssh git@github.com

如图，显示这样就算成功了

上传至 Github

在Github上新建一个仓库，Repository Name 填你的GitHub用户名.github.io，仓库状态设为 Public，点击 Create Repository 创建新的网站仓库。

安装 Hexo 的扩展 hexo-deployer-git，务必在博客文件夹下执行：

1
**npm install hexo-deployer-git --save**

****用VSCode打开博客下的的_config.yml文件，拖到最下面，修改deploy部分为

1
deploy:
2
type: git
3
repo: [git@github.com](mailto:git@github.com):你的用户名/你的用户名.github.io.git
4
branch: master

修改完成后按Command + S保存，此时就可以使用hexo d把存在本地的博客部署到Github上了： ****记住这两条命令，之后更新网站经常用得到

1
#生成博客
2
hexo g
3
#将博客推送到指定的地方，在这里是我们的Github仓库
4
hexo d

打开仓库的 Github Pages 功能

打开仓库的 Settings -> Pages，将 Build and deployment 项下的 Source 设置为「Deploy from a branch」，Branch 选择「master」，单击 Save 保存，Pages 功能就被打开了，每次hexo d，更新后的网页都将被自动部署到 Github Pages。

保存后，打开你的用户名.github.io就能看到你的博客了。

至此，你的博客就已经部署在了GitHub上了。剩下的就是创作与上传了。

开始写作

cd到blog目录下，生成一篇新文章：

1
$ hexo new <title>

执行后会在blog/source/_post文件夹里生成一个名为<title>.md的文件，打开它即可使用 Markdown 开始写作，用什么编辑器随你喜好。我用的Notion。

写完后想要上传：

1
#注意以下命令需要切换到blog文件夹(cd blog)执行
2
$ hexo g
3
$ hexo d

如果没有生效，执行：

$ hexo clean

然后再执行上传操作。

Enjoy your write.😜

Fin.