hexo 日常使用
Hexo 是一个基于 Node.js 的快速、简洁且高效的静态博客框架，使用 Markdown 或其他标记语言撰写文章，几秒内即可生成静态网页。以下是 Hexo 的基本使用流程，适用于初学者快速上手。
一、安装前提
在安装 Hexo 前，需先安装以下两个工具：
- Node.js（建议 12.0 或更高版本）
- Git（用于部署到 GitHub 等平台）
可通过命令行验证是否已安装：
2
git --version
二、安装 Hexo
全局安装 Hexo CLI：
1
npm install -g hexo-cli
创建博客目录（必须为空）：
1
mkdir myblog && cd myblog
初始化 Hexo 站点：
1
hexo init
安装依赖包：
1
npm install
三、常用命令速查
生成静态文件：
1
hexo generate
启动本地服务器（默认端口 4000）：
1
hexo server
新建文章：
1
hexo new "文章标题"
文章保存在
source/_posts/目录下。新建页面（如关于页）：
1
hexo new page about
部署到远程仓库（如 GitHub Pages）：
1
hexo deploy
清理缓存与生成文件：
1
hexo clean
更多命令详见官方文档：Hexo Commands
四、配置部署（以 GitHub Pages 为例）
在
_config.yml中配置部署信息：1
2
3
4deploy:
type: git
repo: https://github.com/你的用户名/你的用户名.github.io.git
branch: main安装 Git 部署插件：
1
npm install hexo-deployer-git --save
生成并部署：
1
hexo g -d
访问你的博客：
https://你的用户名.github.io
五、更换主题（可选）
下载主题到
themes/目录，例如：1
git clone https://github.com/yelog/hexo-theme-3-hexo.git themes/hexo-theme-3-hexo
修改
_config.yml中的theme字段：1
theme: hexo-theme-3-hexo
清理并重新生成：
1
hexo clean && hexo g && hexo s
主题市场：Hexo Themes
六、写作与资源管理
- 文章使用 Markdown 编写，支持 Front Matter（如标题、日期等）。
- 启用文章资源文件夹（自动为每篇文章创建资源文件夹）：
1
2_config.yml
post_asset_folder: true - 引用图片推荐使用标签插件：
1
{% asset_img example.jpg "示例图片" %}
详情见：写作指南
七、常见问题
- 权限错误（EACCES）：建议使用
nvm（Node 版本管理器）安装 Node.js 。 - 中文乱码：确保文件保存为 UTF-8 编码。
- 部署失败：检查 Git 配置和仓库地址是否正确。
如需完整实战教程，可参考：CSDN Hexo 完整使用指南 。
