搭建博客

别是太空人2025-02-062025-02-09

利用Hexo搭建个人博客

Hexo 是一个快速、简洁的静态博客框架，使用 Node.js 构建。在本篇文章中，我将带你从头到尾搭建一个基于 Hexo 的博客，并将它部署到 GitHub 上，分享给大家。

首先，确保你已经安装了以下环境：

Node.js
最新版的 Node.js 是必需的，可以通过 Node.js 官网下载并安装。安装完成后，验证安装是否成功：
1
2
node -v
npm -v
如果成功显示版本号，说明安装没有问题。
Git
Git 是用来管理代码的工具。如果你还没安装 Git，可以到 Git 官网下载并安装。安装完成后，验证：
1
git -v
国内镜像
在国内访问 GitHub 可能会比较慢，建议使用 Watt Toolkit 或者使用淘宝 NPM 镜像源来加速安装：
1
npm install -g cnpm --registry=https://registry.npmmirror.com
VS Code（可选）
如果你习惯在本地进行代码编辑，可以安装 VS Code 来辅助编辑和调试。

全局安装 Hexo CLI
通过 NPM 或 CNPM 安装 Hexo 命令行工具：
1
npm install -g hexo-cli
初始化 Hexo 项目
选择一个文件夹来放置你的博客文件，然后通过以下命令初始化 Hexo 项目：
1
2
hexo init my_blog
cd my_blog
如果初始化过程中卡住，可以按 CTRL + C 终止，然后继续下一步。
安装依赖
使用阿里云镜像源来安装项目的依赖：
1
cnpm install
解决 SSL 错误（如有）
如果出现 SSL 证书错误，可以通过以下命令绕过证书验证：
1
git config --global http.sslVerify false

选择 Hexo 主题
你可以选择一个你喜欢的主题，比如 Butterfly 主题，在 GitHub 上找到主题的页面并下载或者直接克隆到本地：
1
git clone https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
修改主题设置
打开 Hexo 项目的 _config.yml 文件，修改 theme 为你选择的主题名称：
1
theme: butterfly

清理缓存和生成静态文件
在开始预览之前，首先清理缓存并生成静态文件：
1
2
hexo clean
hexo generate
启动本地服务器
启动 Hexo 的本地开发服务器，然后在浏览器中访问：
1
hexo server
默认地址是 http://localhost:4000，你可以在浏览器中查看效果。

在 GitHub 上创建一个新仓库
在 GitHub 上创建一个新的仓库，用来存放你的博客内容。
安装部署插件
使用 Hexo 部署插件将博客推送到 GitHub 上：
1
npm install hexo-deployer-git --save
如果你使用的是国内镜像：
1
cnpm install hexo-deployer-git --save
配置 Hexo 部署信息
在 Hexo 项目的 _config.yml 文件中，找到并修改 deploy 配置项，填写你的 GitHub 仓库信息：
1
2
3
4
deploy:
type: git
repo: https://<你的访问令牌>@github.com/你的用户名/你的仓库名.git
branch: main
部署到 GitHub
完成配置后，你可以通过以下命令将博客内容推送到 GitHub：
1
hexo deploy
如果是第一次部署，Hexo 会将生成的静态文件推送到 GitHub 上。

除了 GitHub Pages，你还可以使用一些免费的容器平台来托管你的博客，比如 Zeabur 或者 Vercel 等，目前Zeabur可能已经付费，可以去阿里云
注册域名购买服务器进行备案。

通过这些步骤，你就可以顺利搭建并部署自己的 Hexo 博客了！希望这篇文章对你有帮助。如果在安装或配置过程中遇到问题，可以随时回到文章查看细节或提问。



## 联系信息
如有问题或建议，请联系 [2894812875@qq.com/vx:18939123945]。