博客搭建(一)-本地搭建hexo blog开发环境

开发环境

macOS 版本非必须的，不用太在意。
各个软件的版本并不需要按照下方版本列表严格执行，这里只是记录了我搭建完成的各种版本号，大家可以根据自己的情况调整，如果遇到问题或者error再去具体分析解决。
关于node版本在部署到github pages时我用的node 19.x, 因为20.3.1在github flows会有部署失败的情况，后续文章会讲到。

• macOS Ventura: 13.4.1
• Homebrew: 4.0.28
• node: v20.3.1
• hexo: 7.0.0-rc2
• hexo-cli: 4.3.1
• git version: 2.41.0

配置安装

安装Homebrew

Homebrew是一款包管理工具，目前支持macOS和linux系统。主要有四个部分组成: brew、homebrew-core 、homebrew-cask、homebrew-bottles。

名称	说明
brew	Homebrew 源代码仓库
homebrew-core	Homebrew核心源
homebrew-cask	提供 macOS 应用和大型二进制文件的安装
homebrew-bottles	预编译二进制软件包

Homebrew官网
安装Xcode Comand Line Tools(如果电脑中已安装xcode可以忽略此步骤):

xcode-select --install

打开终端，输入如下命令

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

等待安装完成，完成后可以执行一下命令验证安装是否完成。

brew -v

终端打印出 Homebrew x.x.x 的版本号信息证明安装成功。

备注：此文章主要说的是hexo，所以描述的是Homebrew安装没遇到问题的流程，详细教程参考：Mac包管理工具-Homebrew

安装node

打开终端，输入如下命令

brew search node

出现会如下结果

继续终端输入

brew install node

如果想要安装其他版本的node，比如说18.x，可以输入

brew install node@18

安装完成后可以通过以下命令验证安装是否成功：

可以正常查看版本号即可。
如果提示找不到node或npm命令，那么可能是由于node环境变量未配置。打开当前用户目录，打开隐藏文件（快捷键：command+shift+.），用文本编辑器打开 .bash_profile或者.zshrc，添加对应环境变量即可。
查看node路径命令如下：

which node

查看npm路径命令如下：

which npm

安装git

git是作为后续部署到github pages才会用到，但是作为开发环节比较基础的工具，我们事先准备好它。
终端运行如下命令安装：

brew install git

安装完成后运行：

git --version

如果正常输出版本信息，证明安装成功。
如果提示找不到git命令，那么也可能是环境变量配置问题，同node配置环境变量步骤，解决此问题。

另外对于git会有一些可视化的工具，目前用过比较好用而且免费的有：Fork、SourceTree。

个人感觉Fork更好用些。

安装hexo

终端运行如下命令：

npm install -g hexo-cli

安装成功后cd到目标目录运行如下命令创建blog：

hexo init blog

创建成功后可通过以下命令本地查看你的网站：

hexo new test-blog

hexo g

hexo s

浏览器打开http://localhost:4000/ 可查看你的blog雏形。

至此基于hexo的blog开发环境已经搭建完毕。