Mac OS 轻松搭建 Hexo 个人博客：从零到一保姆级教程

嘿，朋友！想拥有一个完全属于自己的个人博客吗？是不是在网上找了一圈，发现大多数教程都是基于 Windows 的，Mac 用户的攻略少之又少？别担心，这篇文章就是为你准备的。

其实，在 Mac OS 上使用 Hexo 搭建博客，比你想象的要简单得多。Hexo 是一个快速、简洁且高效的博客框架，让你能用酷酷的 Markdown 来写文章，然后一键生成精美的静态网页。

准备好了吗？让我们开始吧！

第一步：准备工作，给你的 Mac 装上“神兵利器”

在正式开始前，我们需要先安装几个必备的工具：Homebrew、Git 和 Node.js。别被这些名字吓到，我会一步步带你搞定。

1. 安装 Homebrew

Homebrew 是 Mac 上的一个包管理器，你可以把它想象成一个应用商店，只不过是专门给程序员用的。通过它，安装各种开发工具就是一条命令的事儿，非常方便。

对于国内用户，由于网络原因，建议使用国内镜像源来安装，速度会快很多。打开你的“终端”（Terminal）应用，复制粘贴下面的命令，设置一下环境变量：

# 设置 Homebrew 镜像源地址
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"

然后，运行下面的安装脚本：

# 使用中科大镜像源的安装脚本
/bin/bash -c "$(curl -fsSL https://mirrors.ustc.edu.cn/misc/brew-install.sh)"

如果你的网络环境很好，可以直接使用官方脚本，跳过设置环境变量那一步：

# Homebrew 官方安装脚本
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. 安装 Git 和 Node.js

Homebrew 安装好之后，我们就可以用它来安装 Git 和 Node.js 了。Git 是一个版本控制工具（部署博客到 GitHub 时会用到），而 Node.js 是 Hexo 运行所必需的环境。

在终端里继续输入：

brew install git
brew install node

3. 测试一下是否安装成功

为了确保万无一失，我们来检查一下。在终端里依次输入下面的命令：

node -v
npm -v
git --version

如果终端分别显示了它们各自的版本号，比如 v18.17.0 这样的信息，那就说明我们的准备工作完美收官！

第二步：安装 Hexo，创建你的第一个博客

环境准备就绪，主角 Hexo 终于要登场了。

1. 全局安装 Hexo

使用 npm (安装 Node.js 时会附带安装) 来安装 Hexo 的命令行工具：

npm install -g hexo-cli

2. 初始化你的博客

选一个你喜欢的地方，比如你的用户主目录，然后执行下面的命令来初始化博客项目：

# "blog" 这个名字可以换成任何你喜欢的，比如 "my-awesome-blog"
hexo init blog

这个命令会创建一个名为 blog 的文件夹，并把博客所需的所有文件都放在里面。

3. 本地预览你的博客

现在，让我们进入这个文件夹，并启动博客看看效果！

# 切换到你的博客目录
cd blog

# 生成静态文件
hexo g

# 启动本地服务
hexo s

终端会提示服务已经启动，现在打开你的浏览器，访问 http://localhost:4000，就能看到你的博客啦！是不是很激动？这个预览功能是实时的，你在本地修改任何文件，浏览器里的页面都会自动刷新，调试起来特别方便。

第三步：部署到 GitHub，让全世界看到你的博客

本地的博客只有自己能看，要让别人也能访问，我们需要把它部署到互联网上。GitHub Pages 是一个免费又好用的静态网站托管服务，是 Hexo 博客的完美搭档。

1. 配置 SSH Key 到 GitHub

为了让你的电脑能安全地和 GitHub 通信（比如推送代码），我们需要配置一下 SSH Key。

提示：如果你之前因为其他项目已经配置过，可以跳过这一步。

首先，设置你的 Git 用户名和邮箱：

git config --global user.name "你的GitHub用户名"
git config --global user.email "你的GitHub注册邮箱"

然后，生成 SSH Key：

# 记得把邮箱换成你自己的
ssh-keygen -t rsa -C "你的GitHub注册邮箱"

生成过程中会让你确认存放位置和设置密码，一路按回车键使用默认设置即可。

完成后，公钥文件会存放在 ~/.ssh/id_rsa.pub。我们需要复制里面的内容。你可以通过访达前往文件夹 ~/.ssh (按 Command+Shift+G 输入路径)，然后用文本编辑器打开 id_rsa.pub 文件，全选并复制。

接下来，打开 GitHub 网站，进入 Settings -> SSH and GPG keys，点击 New SSH key。Title 可以随便填，比如 “My MacBook Pro”，然后在 Key 的文本框里粘贴你刚刚复制的内容，最后点击 Add SSH key。

最后，我们来测试一下连接是否成功：

ssh -T [email protected]

如果看到 Hi username! You've successfully authenticated... 这样的信息，就说明配置成功了！

2. 创建 GitHub 仓库

在 GitHub 上新建一个仓库，仓库名必须是 你的用户名.github.io 的格式。比如，如果你的用户名是 octocat，那么仓库名就应该是 octocat.github.io。仓库一定要设置为 Public（公开）。

3. 配置 Hexo 部署信息

首先，我们需要安装一个部署插件，让 Hexo 知道如何通过 Git 来部署。

# 确保你当前在博客的根目录 (比如 blog 文件夹) 下执行
npm install hexo-deployer-git --save

然后，打开你博客根目录下的 _config.yml 文件，拉到最底部，找到 deploy 配置项，修改成下面这样：

deploy:
  type: git
  repo: [email protected]:你的用户名/你的用户名.github.io.git
  branch: main # 或者 master，取决于你的 GitHub 仓库默认分支名

注意：现在 GitHub 新建仓库的默认分支名是 main，请根据你的实际情况填写 branch。

4. 执行部署

万事俱备，只欠东风！执行下面两条命令，一键部署你的博客：

# 先生成最新的静态文件
hexo g

# 再部署到 GitHub
hexo d

⚠️ 首次部署可能会遇到的坑

当你第一次执行 hexo d 时，终端可能会提示你输入 GitHub 的密码。千万不要输入你的登录密码！ 因为 GitHub 在 2021 年后就不再支持使用密码进行 Git 操作了。

正确做法是：

1. 去 GitHub 的 Settings -> Developer settings -> Personal access tokens -> **Tokens (classic)**。
2. 点击 Generate new token，Note 随便填，Expiration 建议选 “No expiration”，Select scopes 勾选 repo 权限。
3. 生成 Token 后，立刻复制并保存好它，因为这个页面关了就再也看不到了。
4. 回到终端，在提示输入密码的地方，粘贴你刚刚复制的 Personal Access Token，然后回车。

5. 开启 GitHub Pages 功能

部署成功后，还需要在仓库设置里最后确认一下。

进入你刚刚创建的 你的用户名.github.io 仓库，点击 Settings -> Pages。在 Build and deployment 下，将 Source 设置为 Deploy from a branch，Branch 选择你刚刚推送代码的分支（main 或 master），然后点击 Save。

稍等片刻，你的博客就成功上线啦！访问 https://你的用户名.github.io 就能看到它了。

第四步：开始写作，成为博主！

博客搭好了，最重要的当然是写文章。

1. 创建新文章

使用下面的命令来创建一篇新文章：

hexo new "我的第一篇文章"

Hexo 会在 source/_posts 文件夹下创建一个名为 我的第一篇文章.md 的 Markdown 文件。

2. 开始写作

打开这个 .md 文件，你会看到文件顶部有一段被 --- 包围的内容，这叫做 Front-matter，用来配置文章的元信息，比如标题、日期、标签等。

---
title: 我的第一篇文章 # 文章的标题，会显示在页面上
date: 2025-09-07 10:00:00
tags:
---

在这里开始你的正文内容...

Front-matter 下方就是你用 Markdown 书写正文的地方。

3. 发布文章

写完文章后，保存文件。然后回到终端，执行三连命令：

# 1. 清理旧的生成文件 (推荐养成好习惯)
hexo clean

# 2. 生成新的静态文件
hexo g

# 3. 部署到 GitHub
hexo d

刷新你的博客网站，新文章就发布成功啦！

附录：Hexo 常用命令速查

命令	完整形式	作用
hexo n "标题"	hexo new "标题"	创建一篇新文章
hexo g	hexo generate	生成静态文件
hexo s	hexo server	启动本地预览服务
hexo d	hexo deploy	部署网站
hexo clean	hexo clean	清除缓存及已生成的静态文件

---

恭喜你！到这里，你已经成功在 Mac 上搭建并发布了你的个人博客。接下来，你还可以探索更换主题、安装插件等更多玩法，让你的博客变得更加个性化。享受写作的乐趣吧！