🖼 所有搭建博客的汇总在这里:Blog全程搭建,本部分示例🚀test.ruiqingyan.com

这一篇完成四件事:安装 Homebrew、安装 Git、用 SSH 绑定 GitHub、安装 Node.js 和 npm。配置完成后,下一篇就可以正式初始化 Hexo 项目。

2402.1.终端(一般在启动台—>其他—>终端)

1、安装 Homebrew

Homebrew 是 Mac 上常用的软件包管理工具,后面安装 Git、Node.js 都会用到它。

打开终端,粘贴下面命令并回车:

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
2402.2.选择镜像源,下载brew

安装结束后,终端可能会提示把 Homebrew 加入环境变量。Apple 芯片 Mac 常见命令如下:

1
2
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Intel 芯片 Mac 常见命令如下:

1
2
echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

最后检查是否安装成功:

1
2
brew --version
brew doctor

如果官方安装命令因为网络问题一直失败,可以临时用国内镜像脚本辅助安装;但初学阶段要记住,复制运行脚本前最好确认来源可信。

2、安装 Git

Git 用来管理代码版本,也用来把本地 Hexo 博客推送到 GitHub。

1
2
brew install git
git --version
2402.3.查看git版本

第一次使用 Git 时,建议配置用户名和邮箱。这里的邮箱最好和 GitHub 注册邮箱一致:

1
2
3
git config --global user.name "你的GitHub用户名"
git config --global user.email "your_email@example.com"
git config --global --list

3、Git 绑定 GitHub

3.1 生成 SSH key

下面的邮箱要换成自己的 GitHub 邮箱。私钥文件 id_ed25519 只能留在自己电脑里,不要发给别人;上传到 GitHub 的是 .pub 结尾的公钥。

1
2
3
mkdir -p ~/.ssh
cd ~/.ssh
ssh-keygen -t ed25519 -C "your_email@example.com"

终端会询问保存位置,如果你第一次配置,直接回车即可,默认会生成:

1
2
~/.ssh/id_ed25519
~/.ssh/id_ed25519.pub

如果提示 id_ed25519 already exists,说明电脑上已经有 SSH key,先不要覆盖,确认是否已经能连接 GitHub。

2402.4.mac本地秘钥

把 SSH key 加入本机代理:

1
2
3
eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519 2>/dev/null || ssh-add ~/.ssh/id_ed25519
chmod 600 ~/.ssh/id_ed25519

复制公钥:

1
pbcopy < ~/.ssh/id_ed25519.pub

如果 pbcopy 没反应,也可以直接打印出来手动复制:

1
cat ~/.ssh/id_ed25519.pub

3.2 把公钥放到 GitHub

进入 GitHub 右上角头像,按下面路径添加:

1
Settings -> SSH and GPG keys -> New SSH key

Title 随便写一个能认出来的名字,比如 MacBook Air;Key type 选 Authentication Key;Key 里粘贴刚才复制的 .pub 公钥。

2402.5.打开github 2402.6.打开github设置 2402.7.进入SSH配置 2402.8.粘贴自己公钥 2402.9.配置成功

3.3 测试 GitHub SSH 连接

回到终端,执行:

1
ssh -T git@github.com

第一次连接时会询问是否继续,输入 yes 回车。成功时一般会看到类似下面的提示:

1
Hi 用户名! You've successfully authenticated, but GitHub does not provide shell access.
2402.10.成功绑定github

4、安装 Node.js

Node.js 是运行 Hexo 所需的环境;npm 会随 Node.js 一起安装。

前面已经安装了 Homebrew,所以可以直接用下面命令:

1
2
3
brew install node
node -v
npm -v
2402.12.检查安装

进入官网:https://nodejs.org/en/download

建议选择 LTS 版本,下载 macOS 安装包后一路下一步安装即可。

2402.11.下载安装包

最后打开终端检查:

1
2
node -v
npm -v
2402.12.检查安装

如果后续安装 npm 包很慢,可以把 npm registry 临时切到国内镜像:

1
2
npm config set registry https://registry.npmmirror.com
npm config get registry

5、最终检查

这一篇结束前,把下面命令都跑一遍:

1
2
3
4
5
brew --version
git --version
node -v
npm -v
ssh -T git@github.com

如果都能正常显示,说明本地基础环境已经准备好了。下一篇进入 1-3 本地部署 Hexo,推送到 GitHub