最开始以为搭博客很简单，没想到用了几天时间。避坑建议：多看官方说明

前提

1. 需要安装git，hexo，gh（GitHub CLI），Node.js，mac上最好提前安装brew，再利用brew安装比较简单
2. 注册一个 Github 账号，新建一个项目名为“用户名.github.io”
3. 在 Github 设置Token：Setting --> Developer settings --> Personal access tokens --> Tokens (classic) --> Generate new token

账号设置

为计算机上的每个存储库设置 Git 用户名

邮箱建议使用 Github 提供的邮箱 *@users.noreply.github.com ，可以在 Setting –> Emails 处看到，隐匿真实邮箱

git config --global user.name "用户名"
git config --global user.email "邮箱"

查看设置的用户名

git config --global user.name

删除设置的用户名

git config --global --unset user.name "用户名"

缓存凭据

方便后续远程上传，不用每次输入token

gh auth login

依次选 Github.com --> 输入y --> HTTPS --> 输入y --> Paste an authentication token --> 把上面设置的Token粘贴，缓存就搞好啦

Hexo 搭建博客

建站

hexo init <folder>
cd <folder>
npm install

选择主题

https://hexo.io/themes/

git clone 到/themes

根据需要修改博客根目录下的_config.yml以及所选主题下的_config.yml，具体内容可以参考主题介绍，下面说一些常用操作

新建文章

hexo new "文章标题"

新建目录及目录下的 index.md

hexo new page 目录名

Front-matter 的常用参数及格式

---
title: Hello World
date: 2013/7/13 20:46:25
# 分类
categories:
- Diary
# 标签
tags:
- PS3
- Games
---

首页摘要

使用<!-- more -->分割摘要和内容

生成静态文件

hexo g

启动服务器

在本地查看博客

hexo s

注：在某些情况（尤其是更换主题后），对站点的更改不生效，运行该命令清除缓存文件 (db.json) 和已生成的静态文件 (public)

hexo clean

上传部署

修改根目录下的 _config.yml

deploy:
  type: git
  repository: https://github.com/用户名/用户名.github.io.git
  branch: main

安装 hexo-deployer-git 模块

npm install hexo-deployer-git --save

上传至 Github

hexo d

等一两分钟，访问https://用户名.github.io，看成果！