阿良の小屋

电脑上搭建 Hexo 环境

2026-02-18

  1. 下载并安装 nodejs

    32 位下载地址:
    https://nodejs.org/dist/v20.20.0/node-v20.20.0-x86.msi
    64位下载地址:
    https://nodejs.org/dist/v20.20.0/node-v20.20.0-x64.msi
  2. 使用以下命令在全局环境安装 hexo-cli

    npm install hexo-cli@4.3.2 -g
  3. 创建并初始化网站目录,用 npm 安装依赖

    hexo init <folder>
    cd <folder>
    npm install

初始化后,您的项目文件夹将如下所示:

.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

其中 _config.yml 为网站的配置文件。

source 为源文件夹,所有写作的文章都存放在 _posts 文件夹中。

themes 为主题文件存放处,例如本网站使用的主题是 Vexo,则存在 vexo 目录。vexo 目录中的 _config.yml 是主题配置文件,可以复制到 hexo 根目录,并重命名为 _config.vexo.yml 方便修改。(_config.vexo.yml 的优先级大于 vexo 目录中的 _config.yml)(该特性自 Hexo 5.0.0 起提供)

  1. 修改网站的配置文件
    参考文档 https://hexo.io/zh-cn/docs/configuration 进行配置。

  2. 常用 hexo 命令

    1、创建一篇名为 title 的空白文章:
    hexo new [layout] <title>

    2、生成网站(生成 public 文件夹)
    hexo generate | hexo g

    3、清理生成的网站(删除 public 文件夹)
    hexo clean

    4、预览网站,默认网址是:http://localhost:4000/
    hexo server | hexo s

    5、部署网站
    hexo deploy | hexo d

扫描二维码,分享此文章