Hexo博客保姆级安装教程

这儿有一堆花2026-01-14 8:58

要顺利运行 Hexo，计算机必须具备两个核心的基础环境：Node.js 和 Git。这两者构成了 Hexo 运行的底层逻辑，前者提供运行环境，后者负责版本控制与部署。

Node.js 官方下载： https://nodejs.org/en/

对于国内的网络环境而言，直接使用默认的 NPM 源下载依赖包往往会遭遇连接超时或速度极其缓慢的问题，这会严重消磨搭建者的耐心。切换镜像源是安装 Hexo 前最关键的一步优化。通过配置国内的镜像服务器，可以显著提升后续所有组件的下载速度。

bash 复制代码

npm config set registry https://registry.npmmirror.com

环境配置完毕后，即可安装 Hexo 的命令行工具。这是操作 Hexo 博客的核心入口，未来的新建文章、生成页面以及部署上线都将依赖这个工具完成。安装过程应当在全局环境下进行，以确保你在系统的任何目录下都能随时调用 Hexo 命令。

输入以下命令进行安装：

bash 复制代码

npm install -g hexo-cli

当命令行工具安装成功，你便拥有了创建一个全新博客站点的能力。选择一个合适的文件夹作为你的博客根目录，初始化过程会自动下载所需的所有依赖文件和默认主题。这个过程建立了一个完整的骨架，包含了配置文件、源代码目录以及主题文件夹。

初始化命令如下：

bash 复制代码

hexo init my-blog
cd my-blog
npm install

此时，你的博客雏形已经建立在本地硬盘上。为了验证安装是否成功，需要在本地启动一个预览服务器。这一步能让你在浏览器中实时查看博客的样貌，是后续修改配置和撰写文章时最常用的功能。

启动本地服务器：

bash 复制代码

hexo server

打开浏览器并访问 http://localhost:4000，如果能看到默认的页面，说明 Hexo 已经成功在你的电脑上安家落户。