Hexo 系列 - 1. 安装

1. 安装 Node.js

  • 前往 Node.js 官网下载安装包,根据提示安装即可。
  • 安装 Node.js 之后,npm 会一起安装好。两者关系可以简单理解成:
    • Node.js = 运行环境(让你能在本机运行 JavaScript 的“引擎”)
    • npm = 包管理器(用来安装 / 更新 / 管理 各种 JavaScript / Node 的第三方库)
    • 就像:Python(解释器) + pip(包管理器)
  • 安装后,检查版本号:
    1
    2
    node -v
    npm -v
    命令行输出版本号说明安装成功
  • 上名指令之所以会在命令行成功执行,是因为
    • PATH 里添加了 Node 的安装目录: C:\Program Files\nodejs\
    • PATH 里添加了 npm 的安装目录:%APPDATA%\npm = C:\Users\XXX\AppData\Roaming\npm

2. 安装 git

安装 git 这里不再赘述,安装完 git 后,检查版本号:

1
git --version
命令行输出版本号说明安装成功

接下来需要让 npm 识别 git:

1
npm install -g hexo-deployer-git
命令行无报错说明安装成功

3. 利用 npm 安装 Hexo

注意以下两种安装方式的区别

🔍 全局安装 npm install -g hexo-cli

  • -g:全局安装(global)

  • 安装的包:hexo-cli,也就是 hexo 的“命令行工具”

  • 作用:在系统里安装一个全局的 hexo 命令,之后在任意目录都可以在命令行执行:

    1
    2
    3
    4
    hexo init
    hexo new
    hexo g
    hexo s

    这相当于装了一个“Hexo 启动器”。

🔍 本地安装 npm install hexo

  • 没有 -g:本地安装(只装在当前目录的 node_modules 下)

  • 安装的包:hexo 核心引擎(生成博客的真正库)

  • 作用:给当前博客项目目录 myblog 安装 Hexo 作为依赖。接下来,只能在博客项目目录 myblog 运行:

    1
    npm install hexo
    博客项目目录 myblog 会有:

    • node_modules/hexo 文件夹
    • package.json 文件

    博客项目目录 mybloghexo 优先级会高于全局的 hexo-cli 。

✅ 搭建博客时 - 全局安装 hexo-cli:npm install -g hexo-cli - 后面使用 hexo 初始化博客项目目录 myblog 时,也会在博客项目目录 myblog 下创建 - node_modules/hexo 文件夹 - package.json 文件


Hexo 系列 - 1. 安装
http://yylustb.github.io/2025/11/14/code/HEXO/hexo_1/
作者
yylustb
发布于
2025年11月14日
许可协议