1-2 配置Brew、Git、Git绑定Github、Node
🖼 所有搭建博客的汇总在这里:Blog全程搭建,本部分示例🚀test.ruiqingyan.com。
这一篇完成四件事:安装 Homebrew、安装 Git、用 SSH 绑定 GitHub、安装 Node.js 和 npm。配置完成后,下一篇就可以正式初始化 Hexo 项目。
命令尽量以官方文档为准:
- Homebrew 官方安装说明:https://docs.brew.sh/Installation
- GitHub SSH 官方说明:https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent
- Node.js 官方下载页:https://nodejs.org/en/download
1、安装 Homebrew
Homebrew 是 Mac 上常用的软件包管理工具,后面安装 Git、Node.js 都会用到它。
打开终端,粘贴下面命令并回车:
1 | /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" |
安装结束后,终端可能会提示把 Homebrew 加入环境变量。Apple 芯片 Mac 常见命令如下:
1 | echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile |
Intel 芯片 Mac 常见命令如下:
1 | echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile |
最后检查是否安装成功:
1 | brew --version |
如果官方安装命令因为网络问题一直失败,可以临时用国内镜像脚本辅助安装;但初学阶段要记住,复制运行脚本前最好确认来源可信。
2、安装 Git
Git 用来管理代码版本,也用来把本地 Hexo 博客推送到 GitHub。
1 | brew install git |
第一次使用 Git 时,建议配置用户名和邮箱。这里的邮箱最好和 GitHub 注册邮箱一致:
1 | git config --global user.name "你的GitHub用户名" |
3、Git 绑定 GitHub
3.1 生成 SSH key
下面的邮箱要换成自己的 GitHub 邮箱。私钥文件 id_ed25519 只能留在自己电脑里,不要发给别人;上传到 GitHub 的是 .pub 结尾的公钥。
1 | mkdir -p ~/.ssh |
终端会询问保存位置,如果你第一次配置,直接回车即可,默认会生成:
1 | ~/.ssh/id_ed25519 |
如果提示 id_ed25519 already exists,说明电脑上已经有 SSH key,先不要覆盖,确认是否已经能连接 GitHub。
把 SSH key 加入本机代理:
1 | eval "$(ssh-agent -s)" |
复制公钥:
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 公钥。
3.3 测试 GitHub SSH 连接
回到终端,执行:
1 | ssh -T git@github.com |
第一次连接时会询问是否继续,输入 yes 回车。成功时一般会看到类似下面的提示:
1 | Hi 用户名! You've successfully authenticated, but GitHub does not provide shell access. |
4、安装 Node.js
Node.js 是运行 Hexo 所需的环境;npm 会随 Node.js 一起安装。
前面已经安装了 Homebrew,所以可以直接用下面命令:
1 | brew install node |

如果后续安装 npm 包很慢,可以把 npm registry 临时切到国内镜像:
1 | npm config set registry https://registry.npmmirror.com |
5、最终检查
这一篇结束前,把下面命令都跑一遍:
1 | brew --version |
如果都能正常显示,说明本地基础环境已经准备好了。下一篇进入 1-3 本地部署 Hexo,推送到 GitHub。












