Windows 本地从零搭建 Hexo 写作环境
Windows 本地从零搭建 Hexo 写作环境
高兴宇一、前言
很多新手搭建 Hexo 博客第一步就踩坑：环境装错、版本不对、页面空白、中文乱码。本文带你在 Windows 系统搭建稳定、无报错、适合长期写博客的 Hexo 本地写作环境，搭配 MarkText 编辑器，全程傻瓜式操作。
二、必备环境安装（仅两个）
Hexo 只依赖 Git + Node.js，不需要 PHP、数据库。
1. 安装 Node.js（必装）
推荐稳定版本：Node.js 18.x LTS（不要用 22.x 新版，大量主题报错、页面空白）
安装注意：全程默认下一步，勾选 Add to PATH 自动配置环境变量。
安装完成 CMD 验证：
1 | node -v |
2. 安装 Git
默认下一步安装即可，用于后续同步文件、部署博客。
三、安装 Hexo 核心框架
打开 CMD / Git Bash，全局安装 Hexo 脚手架：
1 | npm install -g hexo-cli |
验证是否安装成功：
1 | hexo -v |
四、初始化本地博客文件夹
找一个纯英文路径文件夹（不要中文、不要空格），执行：
1 | hexo init myblog |
执行完成，本地博客就搭建完毕。
五、本地预览博客
1 | hexo s |
浏览器打开：http://localhost:4000
正常出现页面即为搭建成功。
六、设置全站中文（解决英文月份、英文导航）
打开博客根目录 _config.yml，修改核心配置：
1 | language: zh-CN |
保存后执行刷新命令：
1 | hexo clean && hexo g && hexo s |
七、搭配 MarkText 傻瓜式写作
1. 安装免费所见即所得编辑器 MarkText
2. 设置软件为简体中文
3. 直接打开 source/_posts 目录写文章
无需记忆语法，和 Word 一样傻瓜写作。
八、常用 Hexo 简写命令（必记）
1 | hexo n "文章标题" # 新建文章 |
喜欢这篇文章的人也看了
