主题部署

进入您的博客根目录，把主题下载下来： Bash Icarus 和其他主题不一样，它不使用默认的 EJS 渲染引擎，而是使用性能更好的
Inferno。 如果不做这一步，您的网站会打不开或者是一堆乱码。 1. 卸载 可能会冲突的默认渲染器。

在您的本地电脑（Git Bash）中操作：

---

第一步：下载主题 (Git Clone)

进入您的博客根目录，把主题下载下来：

Bash

cd /f/Blog/myblog  # 确保在博客根目录下
git clone https://github.com/ppoffice/hexo-theme-icarus.git themes/icarus

第二步：安装专用渲染器 (关键步骤！)

Icarus 和其他主题不一样，它不使用默认的 EJS 渲染引擎，而是使用性能更好的 Inferno。 如果不做这一步，您的网站会打不开或者是一堆乱码。

1. 卸载 可能会冲突的默认渲染器（如果没有就不管，报错忽略即可）：

   Bash

   npm uninstall hexo-renderer-ejs hexo-renderer-pug

2. 安装 Icarus 必须的渲染器：

   Bash

   npm install hexo-renderer-inferno --save

第三步：生成配置文件

Icarus 推荐使用一个独立的文件来管理配置，而不是全挤在根目录的 _config.yml 里。

1. 复制一份示例配置：

   cp themes/icarus/_config.yml _config.icarus.yml

   (Windows 用户如果命令报错，可以直接在资源管理器里，把 themes/icarus/_config.yml 复制出来，粘贴到博客根目录，并重命名为 _config.icarus.yml)

注意：Hexo 的机制是“有备胎”：

• 优先找： 它会先去博客根目录找有没有 _config.icarus.yml（你没建，所以没找到）。

• 保底用： 如果没找到，它就会直接读取主题文件夹里自带的那个“出厂设置”文件（就在 themes/icarus/_config.yml 里）。

3. 修改根目录的 _config.yml： 打开根目录下的 _config.yml，找到 theme: 这一行，修改为：

   YAML

   theme: icarus

---

第四步：针对 1M 带宽的“瘦身”优化 (必做)

Icarus 默认资源都在本地，我们需要把它们改成 CDN 加速，这样用户访问时，大文件（jQuery, FontAwesome 等）是由公共服务器提供的，不占您的 1M 带宽。

1. 打开刚才复制出来的 _config.icarus.yml (在博客根目录下)。

2. 搜索 providers 关键字。

3. 修改 cdn 设置：

   YAML

   providers:
     cdn: jsdelivr  # 或者 loli, cdnjs
     font: google   # 字体
     icon: fontawesome # 图标

   建议设置为 jsdelivr 或 loli（国内访问较快）。

第五步：预览与发布

1. 本地预览：

   Bash

   hexo clean
   hexo s

   打开 http://localhost:4000。 如果不报错且页面显示正常，说明 Inferno 渲染器安装成功了。

错误

30613@LAPTOP-4HP8D0VB MINGW64 /f/Blog/myblog

$ hexo config theme icarus

INFO  Validating config

Inferno is in development mode.

INFO  =======================================

 ██╗ ██████╗ █████╗ ██████╗ ██╗   ██╗███████╗

 ██║██╔════╝██╔══██╗██╔══██╗██║   ██║██╔════╝

 ██║██║     ███████║██████╔╝██║   ██║███████╗

 ██║██║     ██╔══██║██╔══██╗██║   ██║╚════██║

 ██║╚██████╗██║  ██║██║  ██║╚██████╔╝███████║

 ╚═╝ ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝

=============================================

INFO  === Checking package dependencies ===

ERROR Package bulma-stylus is not installed.

ERROR Package hexo's version (8.1.1) does not satisfy the required version (^7.1.1).

ERROR Package hexo-component-inferno is not installed.

ERROR Package hexo-util's version (4.0.0) does not satisfy the required version (^3.2.0).

ERROR Package semver's version (6.3.1) does not satisfy the required version (^7.5.4).

ERROR Please install the missing dependencies your Hexo site root directory:

ERROR npm install --save bulma-stylus@0.8.0 hexo@^7.1.1 hexo-component-inferno@^3.1.2 hexo-util@^3.2.0 semver@^7.5.4

ERROR or:

ERROR yarn add bulma-stylus@0.8.0 hexo@^7.1.1 hexo-component-inferno@^3.1.2 hexo-util@^3.2.0 semver@^7.5.4

原因很简单： Icarus 这个主题功能太强大，所以它依赖很多额外的插件（比如 bulma-stylus 用来画样式，inferno 用来渲染组件）。而且，它对 Hexo 的版本要求比较严（你现在装的是最新的 Hexo 8.x，但它觉得 Hexo 7.x 最稳）。

✅ 一键修复命令

请直接在你的 Git Bash 里复制粘贴运行下面这行命令（它会帮你自动补全缺少的插件，并调整 Hexo 版本）：

Bash

npm install --save bulma-stylus@0.8.0 hexo@^7.1.1 hexo-component-inferno@^3.1.2 hexo-util@^3

2. 推送到服务器：

   Bash

   hexo g -d