1. 前期准备工作
- Node ( 必备 )
- Git ( 必备 )
- VSCode ( 可选 )
- 域名,建议配置一个域名以避免被防火墙阻挡,推荐购买链接: https://spaceship.sjv.io/limin
- 配置 Cloudflare,托管域名: 托管教程
- 创建免费图床: 图床搭建教程
- 注册cloudflare怕被扣费,推荐用myfine有50张虚拟卡(需要护照),教程链接: 注册教程
- Hexo官方主题展示: 点击跳转
2.1. 安装 Node
- 从 Node 官网 下载适合自己系统的版本。
- 完成安装,Windows电脑建议使用默认目录
C:/Program Files/nodejs/
,苹果电脑无所谓。 - 验证安装成功,在命令行中输入
node -v
检查版本信息。
- 苹果用户可通过右键文件夹,选择“服务”,新建终端窗口以便操作。
2.2. 安装 Git
- 从 Git 官网 下载适配的 Git 版本。
- Windows 用户可使用默认目录安装 Git,Mac 用户则按提示在终端操作。
- 验证安装完毕后,Windows 用户会在开始菜单中看到
Git Bash
等应用。
2. 配置 Git 密钥并连接至 Github
常用 Git 命令:
bashgit config -l
git config --system --list
git config --global --list
3.1. 配置用户名和邮箱
bashgit config --global user.name "你的用户名"
git config --global user.email "你的邮箱"
3.2. 配置公钥连接 Github
- 生成 SSH 公钥:
bashssh-keygen -t rsa -C "你的邮箱"
一路回车生成密钥,进入 .ssh
文件夹复制 id_rsa.pub
公钥内容,配置到 Github 的 SSH 设置中。
3.在苹果电脑上,如果你知道文件的路径,可以通过以下几种方式快速找到文件:
打开Finder。
按下 Command + Shift + G,在弹出的对话框中输入文件路径,然后按 Enter。这样可以直接跳转到该路径下的文件。
在windows电脑上:
打开C盘下用户文件夹下的.ssh的文件夹,会看到以下文件
id_rsa 私钥
id_rsa.pub 公钥
- 测试连接:
bashssh -T git@github.com
第一次连接会提示Are you sure you want to continue connecting (yes/no/[fingerprint])?,输入yes即可
3.3. 创建 GitHub.io 仓库
4. 初始化 Hexo 博客
- 创建文件夹保存博客源码:
苹果用户随意创建好文件夹后,在文件夹右击,选择“服务”选择“新建终端窗口以便操作”
Windows用户可以(例如 D:/Hexo-Blog),在该文件夹内启动 Git Bash 或终端。
- 安装 Hexo:
bashnpm install -g hexo-cli && hexo -v
- 初始化 Hexo 项目安装依赖:
bashhexo init blog-demo
cd blog-demo
npm i
- 启动项目并验证:
bashhexo cl && hexo s
在浏览器中访问 http://localhost:4000/ 以查看效果。
5. 将静态博客挂载到 GitHub Pages
- 修改
_config.yml
文件,配置repository
为你的 GitHub 地址,分支改为main
:
yamldeploy:
type: git
repository: git@github.com:你的用户名/你的用户名.github.io.git
branch: main
- 安装
hexo-deployer-git
:
bashnpm install hexo-deployer-git --save
- 部署到 GitHub:
bash// Git BASH终端
hexo clean && hexo generate && hexo deploy
// 或者
// VSCODE终端
hexo cl; hexo g; hexo d
访问 https://<用户名>.github.io/
以查看博客。
6. 将静态博客挂载到 Cloudflare Pages
- 通过 Cloudflare Pages 连接 Git 仓库。
- 登录 GitHub,点击保存并部署。
- 部署成功后,访问 Cloudflare 提供的链接。
如有自定义域名,可以在 Cloudflare Pages 中绑定。没有建议去申请,这样博客就不被墙了。
如何使用
新建一篇博文
bashhexo new 这是一篇新的博文
编辑 _posts
文件夹中的新建文章,使用 Markdown 语法编写内容。
本地预览
bashhexo cl && hexo s
推送到 GitHub
bashhexo cl && hexo g && hexo d
进阶教程预告
接下来会介绍 Hexo 主题美化 文章写作 赶紧订阅我吧!
解决 VSCODE 报错
如果首次执行 VSCODE 终端出现报错,可以使用管理员身份打开 PowerShell,并执行以下命令:
bashSet-ExecutionPolicy RemoteSigned