文档 | Hexo 中文

欢迎使用 Hexo 文档。如果您在使用 Hexo 时遇到任何问题，请查看故障排除指南，在GitHub上提交问题，或在Google 论坛上发起主题讨论。

Hexo 是什么？

Hexo 是一个快速、简单、强大的博客框架。您可以在Markdown（或其他标记语言）中编写文章，Hexo 会在几秒钟内生成具有精美主题的静态文件。

只需几分钟即可完成 Hexo 的设置。如果您遇到问题且无法在此找到解决方案，请提交 GitHub 问题，我们会尽力帮助您。

安装 Hexo 非常容易，只需提前满足以下要求即可：

如果您的计算机已具备这些要求，恭喜！您可以跳过Hexo 安装步骤。

如果没有，请按照以下说明安装所有要求。

对于 Mac 用户
在编译时，您可能会遇到一些问题。请先从 App Store 安装 Xcode。安装 Xcode 后，打开 Xcode 并转到**偏好设置 -> 下载 -> 命令行工具 -> 安装**以安装命令行工具。

Node.js 为大多数平台提供官方安装程序。

其他安装方法

nvs 也推荐用于 Mac 和 Linux，以避免可能的权限问题。

Windows
如果您使用官方安装程序，请确保选中**添加到 PATH**（默认情况下已选中）。

Mac / Linux
如果您在尝试安装 Hexo 时遇到 EACCES 权限错误，请按照 npmjs 提供的解决方法操作；强烈建议不要使用 root/sudo 覆盖。

Linux
如果您使用 Snap 安装了 Node.js，您可能需要在初始化博客时在目标文件夹中手动运行 npm install。

安装完所有要求后，您可以使用 npm 安装 Hexo：

$ npm install -g hexo-cli

高级用户可能更喜欢安装和使用 hexo 包。

$ npm install hexo

安装完成后，您可以通过两种方式运行 Hexo：

echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

然后使用 hexo <command> 运行 Hexo

如果您只能使用较旧的 Node.js，可以考虑安装旧版本的 Hexo。

请注意，我们不会为旧版本的 Hexo 提供错误修复。

我们强烈建议您始终安装最新版本的 Hexo和推荐版本的 Node.js，只要有可能。