本文将介绍如何使用Hexo+搭建免费博客以及如何绑定域名。首先将任务拆解成3部分：1、搭建Hexo博客，2、将Hexo博客部署到 Pages，3、使用在阿里云注册的域名绑定。然后讲一下，如果遇到问题，最好先看一下报错提示是什么，然后去网上找一找有没有前人的填坑经验。

昨天折腾了一天，就因为电脑上使用了多个账户，新博客怎么上传部署都报错，刚解决旧问题又冒出新问题，一坑接一坑，坑坑不重样，差一点我就想搭个虚拟机开台新电脑重装了。我前两年都是用安卓机（+hexo）+虚拟机（光速虚拟机++hexo，VMOS用不了）在手机上双开hexo博客的。今年因为 GPT Ai 大发展 重回 ，没想到PC端遇到问题比手机端还难搞，手机端遇到问题大不了直接重装，电脑端重装一下那多费劲，还好很多人跟我遇到一样的问题，能在网上找到解决方法，不然真难搞。

1、搭建Hexo博客

总的来说在上搭建Hexo环境和生成Hexo博客是不会遇到太多问题的。

1.1、安装 Node.js

1.2、安装 Git

1.3、安装 Hexo

右键打开 Git Bash 命令行窗口，输入以下代码，按回车键自动安装Hexo环境。

npm install -g hexo-cli

1.4、创建 Hexo 博客

直接在 D盘 空白处 点击右键打开 Git Bash 命令行窗口，输入以下代码，按回车键，然后自动创建一个“Blog”文件夹并把博客安装在里面。

hexo init Blog

这个操作的意思是把博客安装到“D盘”的“Blog”文件夹里面。

1.5、使用 Hexo 博客

进入你的博客文件夹“D:\Blog”，在文件夹空白处 点击右键进入 Git Bash 命令行窗口，输入以下代码开启本地服务器，然后打开浏览器地址“:4000”预览博客网站。

hexo s （启动本地服务器，预览博客网站）

下面是 清除缓存+生成静态博客+上传到代码库 的命令，括号和里面的注释要去掉。

hexo clean （清除缓存）
hexo g （生成静态博客）
hexo d （上传代码）

发布文章 有两种方式：1、命令行窗口输入代码“hexo new ”，然后在博客文件夹的“\\”目录找到并编辑。2、直接进入博客文件夹“\\”，随便复制一篇“文章.md”修改就是新文章了。我一般是用笔记软件写好内容，然后加上hexo博客文章的开头格式，你也可以用别的笔记软件去写，最好还是用 --，之后改代码方便。（++不要用，作者是台那边的蛙蛙）

更换主题 有很多令人出乎意料的坑，比如有的主题需要文章格式加标签，有的需要有归档页和关于页，有的有各种兼容性问题，问题是千奇百怪的。

在博客文件夹空白处 右键打开Git命令行窗口，输入以下代码（仅供测试），最好更换成你想下载的新主题提供的git下载方式。

git clone https://github.com/varctrl/hexo-theme-empty-light themes/empty-light

你也可以将你找到的主题文件夹放到博客的“”目录。

不管哪种方法更换主题，最后都要回到博客主目录文件夹，打开“.yml”文件，在最底部找到“theme: ”，将“”改成你的新主题名。然后回到 Git 命令行 输入“hexo s”预览你的新主题。

我第一次搭建hexo是在2017年，就是因为换主题退的坑，折腾了3天没找到解决办法，直到某一天看到别人好看的hexo博客，再一次入坑，没想到这一次一路通畅没遇到任何问题。

2、将Hexo博客部署到 Pages

2.1、注册账号，进入账号设置页看一下Email设置，因为默认启动邮箱隐私，连接需要用提供的邮箱名，你也可以取消保护隐私，用你自己的邮箱。

2.2、创建仓库，在网页右上角 有一个加号图标“ + ”，点击创建仓库，创建好仓库后 在仓库设置页首页 标题栏目 下面，手动改名为 → 点左侧栏的 Pages 网页 → “ frome a ” → → Save 保存。（如果已经显示为 / root ，就不用点 save ）

昨天我新建一个新博客，发现设置跟之前不一样了，“ frome a ” → 只有 main 没有 ，找了很多教程才发现需要在仓库的设置首页 更改 ，手动改为 即可。

2.3、配置 .yml 文件

回到博客文件夹，打开“.yml”文件，修改最后几行，后面改成你自己的名称，然后保存。

deploy:
  type: git
  repository: git@github.com:你的账户名/你的仓库名.github.io.git
  branch: master

2.4、安装Git部署插件

在git命令行窗口输入下面的代码

npm install hexo-deployer-git --save

2.5、部署到

然后输入以下代码，清除缓存+生成博客+上传到

hexo clean
hexo g
hexo d

一般情况下是一步ok的。

但有可能会提示你需要输入账号密码，输入账号和密码即可，

也有可能提示你输入邮箱密码，输入邮箱和密码即可，

如果还报错，那就先回到网站 → 点右上方你的头像 → 点最下面的齿轮图标“” → 点左下角的 “ ” → 点左侧显示的钥匙图标 → 点 （） → 生成 或 更新 你的 token令牌，复制你的token令牌代码，然后上传，账号输入邮箱，密码右键点击粘贴输入，不要管它是不是不显示，直接按回车键就ok！

2.6、可能会遇到的问题

一般是不会遇到什么问题的，但一旦遇到，就是各种古怪刁钻。有问题很正常，我们 发现问题 思考问题 解决问题 即可。换主题、装插件、版本问题、兼容问题还有网络问题这种小事就不说了，如果搞不定，就 直接 重装 重装 重装，记得先备份好数据就行，文章没有丢不就等于博客没有丢嘛。

如果是权限问题，你像我一样有多个账号，在上传时报错提示 大号xxx 没有 小号xxx 权限。最简单的解决方案，是在仓库那里设置小号管理权限。如果你不想这么做，那就只能去删除本地所有git仓库的ssh密钥，然后重新设置。

具体操作是在博客文件夹打开git命令窗口，输入

cd ~/.ssh

进入ssh文件，然后输入 “ ls ” 查看有哪些文件。

复制并运行以下代码 删除 ssh key，这句命令行如果你多打一个空格，可能就要重装系统了，建议复制运行。

rm -rf ~/.ssh/*

将你所有的本地仓库都这样操作删除ssh key，然后重新上传用上面的步骤即可。如果还遇到问题，就接着看下面的操作。

# 配置用户名和邮箱 
git config --global user.name "github 用户名"
git config --global user.email "github 注册邮箱"

# 生成 ssh 密钥 
ssh-keygen -t rsa -C "github 注册邮箱"

按回车键三次（有的需要你回y，有的需要你回yes）->生成的密钥一般放在本地目录“C:\Users\ADMIN\.ssh”，进入你自己电脑名称的文件打开“.shh文件夹”找到“.pub”，右键打开复制全文->打开->进入仓库的设置页->点击 左下角的 SSH adn GPG keys-> 创建新钥匙 New SSh key-> title标题随便写->把刚才复制的那段代码粘贴到key中，注意 要点选下面那个注意事项，说的是上传权限，不点就是只读。然后保存->回到Git命令行窗口重新上传即可。

一般到这里就ok了，如果还能遇到问题，恕我爱莫能助，还是备份数据，卸载重装吧！

3、使用在阿里云注册的域名绑定

上传部署成功后，绑定域名就简单得多，这里我用的是阿里云的域名。

在博客文件夹里，创建一个 txt 文本文件，里面写上你要解析的域名，保存，然后修改文件名为 CNAME （注意要大写，不需要.txt后缀）。打开阿里云的域名解析页，添加 CNAME 记录 解析到你的地址。最后回到仓库的设置页点击Pages，在网页设置你的域名保存，等DNS验证，启动强制https。

只需等一会儿就解析成功啦！

个人不建议小白折腾hexo//hugo等静态博客生成器，会出错的问题实在是太多了。但如果你只是拿来写作写经验写Wiki等等，用静态博客又是最合适的，只需设置安装一次，写作发文全部都在上，就像使用笔记一样，比做独立博客网站省心得多。