在我决定搭建个人博客的那一刻起，我就知道这将是一段充满挑战与乐趣的旅程。Hexo，作为一个快速、简洁且高效的博客框架，自然成为了我的首选。经过一段时间的摸索与实践，我终于成功搭建起了自己的Hexo博客。在此，我想记录下这段旅程中的点点滴滴，以及一些需要注意的事项，希望能为同样想要搭建Hexo博客的朋友们提供一些参考。

一、准备工作

在搭建Hexo博客之前，需要做好一系列的准备工作。这些工作虽然繁琐，但却是必不可少的。

  1. 安装Node.js：
    Hexo是基于Node.js运行的，因此首先需要安装Node.js。我选择了官网的LTS版本进行安装，确保稳定性。安装过程中，记得勾选“Add to PATH”选项，这样可以方便地在命令行中使用Node.js和npm。
  2. 安装Git：
    Git是一个开源的分布式版本控制系统，对于博客的同步和部署至关重要。我根据操作系统的不同，选择了相应的安装方式，并在安装完成后通过git --version命令验证了安装是否成功。
  3. 注册Github/Gitee账号：
    为了将博客部署到网络上，我注册了Github账号，并创建了一个仓库用于存放博客代码。同时，我也考虑了使用Gitee作为备选方案，因为Gitee在国内的访问速度更快。
  4. 购买域名（可选）：
    虽然Hexo博客可以通过Github Pages等免费服务进行部署，但拥有一个自己的域名无疑会让博客更加专业。我购买了一个与博客主题相关的域名，并完成了备案工作。

二、初始化Hexo博客

一切准备就绪后，我开始初始化Hexo博客。

  1. 安装Hexo CLI：
    在命令行中输入npm install -g hexo-cli命令，全局安装Hexo CLI。安装完成后，通过hexo -v命令验证了安装是否成功。
  2. 创建博客文件夹并初始化：
    我在电脑上新建了一个Blog文件夹，用于存放博客源文件。然后，在命令行中进入该文件夹，输入hexo init命令初始化博客。初始化完成后，文件夹中会出现一系列Hexo相关的文件和文件夹。
  3. 安装npm依赖项：
    进入博客文件夹后，输入npm install命令安装npm依赖项。这一步是确保Hexo能够正常运行的关键。
  4. 启动本地服务器：
    安装完成后，输入hexo g命令生成静态文件，然后输入hexo s命令启动本地服务器。在浏览器中访问http://localhost:4000，就可以看到新部署的网页了。

三、部署Hexo博客

本地测试成功后，接下来就是将博客部署到网络上。

  1. 配置部署信息：
    在博客文件夹中的_config.yml文件中，找到deploy配置项，并配置为Github或Gitee的仓库信息。记得将repository字段替换为自己的仓库地址，并将branch字段设置为main（如果是Github）或master（如果是Gitee）。
  2. 安装部署插件：
    在命令行中输入npm install hexo-deployer-git --save命令，安装Hexo的Git部署插件。这个插件负责将博客代码推送到远程仓库。
  3. 部署博客：
    在命令行中输入hexo clean命令清除缓存文件，然后输入hexo g命令生成静态文件，最后输入hexo d命令部署博客。部署过程中可能会要求输入Github或Gitee的用户名和密码（或token），按照提示输入即可。
  4. 绑定域名（可选）：
    如果购买了域名并希望绑定到博客上，需要在域名解析平台增加相应的解析记录，并在博客的source文件夹中添加CNAME文件。然后，在Github或Gitee的仓库设置中配置自定义域名。

四、注意事项

在搭建Hexo博客的过程中，我遇到了一些问题，也总结了一些需要注意的事项：

  1. 网络问题：
    由于npm的默认仓库在国外，下载速度可能会很慢。建议使用淘宝npm镜像或切换网络连接方式来解决这个问题。
  2. 配置问题：
    在配置部署信息时，一定要确保仓库地址和分支名称的正确性。同时，也要注意_config.yml文件中的缩进和空格问题，否则可能会导致配置失败。
  3. 主题选择：
    Hexo提供了丰富的主题供用户选择。在选择主题时，要根据自己的喜好和需求进行挑选，并仔细阅读主题的文档进行配置。
  4. 插件安装：
    Hexo拥有丰富的插件库，可以根据需要安装各种插件来扩展功能。但在安装插件时，要注意插件的兼容性和版本问题。
  5. 备份与恢复：
    定期备份博客代码和数据库是非常重要的。可以使用Git进行版本控制，也可以将代码和数据库导出到本地进行保存。

五、总结

经过一段时间的摸索与实践，我终于成功搭建起了自己的Hexo博客。虽然过程中遇到了一些问题，但正是这些问题让我更加深入地了解了Hexo博客的搭建流程和注意事项。现在，我的博客已经上线并稳定运行着，我也开始在上面记录自己的工作和生活点滴。如果你也想搭建一个属于自己的Hexo博客，不妨参考我的经验和注意事项，相信你一定能够成功！