Hexo博客保姆级安装教程

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

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

Git 官方下载: https://git-scm.com/

对于国内的网络环境而言,直接使用默认的 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 已经成功在你的电脑上安家落户。

相关推荐
极智-9968 小时前
GitHub 热榜项目-日榜精选(2026-02-02)| AI智能体、终端工具、视频生成等 | openclaw、99、Maestro等
人工智能·github·视频生成·终端工具·ai智能体·电子书管理·rust工具
樱花落海洋11112 小时前
GitHub DeskTop Can`t find URP项目
github
我的golang之路果然有问题12 小时前
使用 Hugo + GitHub Pages + PaperMod 主题 + Obsidian 搭建开发博客
golang·go·github·博客·个人开发·个人博客·hugo
codezzzsleep13 小时前
fuClaudeBackend:面向fuclaude的轻量后端代理 + Key 管理后台
ai·github·ai编程
kjzd12314 小时前
GitHub 热门项目趋势分析报告 (2026年2月2日)
github
LostSpeed14 小时前
git - github工程中不能包含大文件
git·github
CoderJia程序员甲15 小时前
GitHub 热榜项目 - 日榜(2026-02-02)
人工智能·ai·大模型·github·ai教程
_oP_i17 小时前
git gui设置github sshkey
git·github
mathematican17 小时前
Git本地修改导致pull失败的解决方法
github
MicrosoftReactor18 小时前
技术速递|GitHub Copilot SDK 与混合 AI 实践:README 到 PPT 的自动化转换流程
人工智能·github·copilot