从零安装 Morii
这篇教程适合第一次使用 Hexo 的读者。跟着做完，你会在自己的电脑上看到 Morii 博客。已经有 Hexo 8 博客的读者，可以从第 3 步：安装主题开始。
先分清两个网站
你正在阅读的是 Morii 主题文档站。下面创建的是你自己的博客。文档站部署在 Cloudflare Pages，不会替你的博客自动上线。
开始前准备
你需要一台能联网的电脑、一个文本编辑器，以及 Node.js 和 Git。Windows 可以使用 PowerShell，macOS 使用“终端”，Linux 使用自己的终端。推荐安装 Node.js 24；Morii 最低要求 Node.js 20.19.0。
安装完后，关闭并重新打开终端，依次输入：
node --version
npm --version
git --version每条命令都应显示版本号。如果提示“找不到命令”，说明软件未安装完成或终端还没有刷新；先解决这一点再继续。Node.js 安装程序会附带 npm。Hexo 官方也把 Node.js 和 Git 列为前置软件，参见 Hexo 安装说明。
1. 创建博客文件夹
打开终端，先进入你想保存博客的目录。下面以用户主目录为例：
cd ~
npm install -g hexo-cli
hexo init my-blog
cd my-blog
npm installWindows PowerShell 中的 cd ~ 同样表示进入用户主目录。my-blog 是你自己博客的文件夹名，可以改成喜欢的英文名字；后面的命令都要在这个文件夹中执行。
这里已经用 npm install -g hexo-cli 安装了全局命令，因此后续在自己电脑上直接输入 hexo。它会在博客目录使用该博客安装的 Hexo 版本。只有没有安装全局 CLI 时，才需要用 npx hexo 调用本地命令。Hexo 官方安装说明
完成后应能看到这些文件：
my-blog/ ← 博客根目录，以后说“在博客根目录运行”就是这里
├─ _config.yml ← Hexo 站点配置
├─ package.json ← 博客依赖
├─ source/
│ └─ _posts/ ← 文章
└─ themes/ ← 通过 Git 安装主题时使用不要进入主题源码仓库操作
建好博客文件夹后，后文的 npm install、hexo ... 都在自己的博客根目录执行，不是在 hexo-theme-morii 主题仓库中执行。
2. 确认 Hexo 版本
在博客根目录运行：
hexo version找到输出中的 hexo 版本。Morii 面向 Hexo 8；如果不是 8.x，先在博客根目录运行：
npm install hexo@^8然后再运行一次 hexo version 确认版本。
3. 安装 Morii 主题
推荐使用 npm。仍在博客根目录运行：
npm install hexo-theme-morii@latest hexo-renderer-pughexo-renderer-pug 用来渲染主题页面，必须安装在博客里。安装完成后，可以运行 npm list hexo-theme-morii hexo-renderer-pug 核对两项依赖。
我更想用 Git 安装
在博客根目录执行下面两条命令，不要再执行上面的 npm 主题安装命令：
git clone https://github.com/xichenx/hexo-theme-morii.git themes/morii
npm install hexo-renderer-pugGit 安装把主题放在 themes/morii/；npm 安装把主题放在 node_modules/hexo-theme-morii/。两种方式任选其一即可。
4. 启用主题
用文本编辑器打开博客根目录的 _config.yml。找到原有的 theme: 一行，把它改成：
theme: morii
language: zh-CN如果文件中已有 language:，也修改原有的那一行，不要写出两个同名配置项。保存文件。此时先不用修改主题安装目录中的 _config.yml，个人设置会放在单独的 _config.morii.yml 中。
5. 生成并预览
回到博客根目录，依次运行：
hexo clean
hexo generate
hexo server终端应显示本地预览地址，通常是 http://localhost:4000/。在浏览器打开它。如果看到 Morii 风格的首页，即表示安装成功。第一次建站时首页可能只有 Hexo 的示例文章，这是正常的。
hexo server 会持续运行。想停止预览时，在该终端按 Ctrl+C。以后修改配置后，建议停止服务、重新生成并再次启动。