文档 | Hexo

欢迎使用 Hexo，本文档将帮助您快速上手。如果您在使用过程中遇到问题，请查看问题解答中的解答，或者在 GitHub、Google Group 上提问。

什么是 Hexo？

Hexo 是一个快速、简洁且高效的博客框架。 Hexo 使用 Markdown（或其他标记语言）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

设置 Hexo 只需几分钟。如果您遇到问题，并且在这里找不到解决方案，请提交 GitHub 问题，我们将提供帮助。

安装 Hexo 相当简单，只需要先安装下列应用程序即可：

如果您的电脑中已经安装上述必备程序，那么恭喜您！你可以直接前往安装 Hexo 步骤。

如果您的电脑中尚未安装所需要的程序，请根据以下安装指示完成安装。

Mac 用户
如果在编译时可能会遇到问题。请先到 App Store 安装 Xcode。 Xcode 完成后，启动并进入 Preferences -> Download -> Command Line Tools -> Install 安装命令行工具。

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

其它的安装方法：

对于 Mac 和 Linux 同样建议使用 nvs 或者 nvm，以避免可能会出现的权限问题。

Windows
使用 Node.js 官方安装程序时，请确保勾选 Add to PATH 选项（默认已勾选）

Mac / Linux
如果在尝试安装 Hexo 的过程中出现 EACCES 权限错误，请遵循由 npmjs 发布的指导修复该问题。

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

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

$ npm install -g hexo-cli

对于熟悉 npm 的进阶用户，可以仅局部安装 hexo 包。

$ npm install hexo

安装以后，可以使用以下两种方式执行 Hexo：

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

安装 Hexo 只需几分钟时间，若您在安装过程中遇到问题或无法找到解决方式，请提交问题，我们会尽力解决您的问题。

如果你坚持使用旧的 Node.js，你可以考虑安装 Hexo 的过去版本。

请注意，我们不提供对过去版本 Hexo 的错误修复。

我们强烈建议永远安装最新版本的 Hexo，以及推荐的 Node.js 版本。