hexo本地环境配置

Hexo本地环境配置主要包括安装Node.js、Git，全局安装Hexo CLI，并初始化项目。以下是详细步骤。

‌1.安装与验证基础环境：‌ 首先安装Node.js（推荐LTS版本，如v16.x以上）和Git。安装后，在终端验证版本：

node -v  # 检查Node.js版本
npm -v   # 检查npm版本
git --version  # 检查Git版本

若未安装，可通过Node版本管理器（如nvm）管理Node.js版本，或从官网下载安装包；Git需从官网获取安装程序。‌12

‌2.全局安装Hexo CLI：‌ 使用npm全局安装Hexo命令行工具：

npm install -g hexo-cli

安装后，可通过hexo version验证安装是否成功。‌

‌3.初始化Hexo项目：‌ 创建项目目录并初始化：

hexo init my-blog  # 创建名为my-blog的项目
cd my-blog         # 进入项目目录
npm install        # 安装依赖包

项目初始化后，核心目录包括：

_config.yml：主配置文件
source/_posts/：存放Markdown文章
themes/：主题目录
package.json：项目依赖配置

4.本地服务器启动与常见问题处理：‌ 启动本地服务器预览博客：

hexo server  # 或 hexo s

访问 http://localhost:4000 查看效果。若命令未识别，可尝试使用 npx hexo … 替代。常见问题包括：

‌命令无法识别‌：检查Node.js和npm是否全局安装，或使用npx前缀。
‌端口占用‌：修改端口为其他值（如hexo server -p 4001）。
‌依赖安装失败‌：清除npm缓存（npm cache clean --force）或检查网络。