废话少说,直接开始!
第一步:安装 Node.js(Hexo 必须依赖)
✅ 操作步骤:
-
点击绿色按钮「LTS 版本」进行下载(推荐版本,比如 18.x 或 20.x)
-
下载完成后双击安装,一路点击【下一步】直到完成(保持默认设置即可)
-
安装完后,重新打开 PowerShell 或 Git Bash,然后测试是否安装成功:
node -v
npm -v
✅ 如果能看到版本号,比如:
v20.12.2 10.7.0
就说明安装成功!
🧰 第二步:安装 Hexo 博客框架
确认 Node.js 安装成功后,在 PowerShell 中输入:
npm install -g hexo-cli
✅ 安装完成后,输入以下命令来检查:
hexo -v
如果显示版本号,比如:
hexo-cli: 4.3.0
说明你已经具备 Hexo 环境啦!
🧱 第三步:初始化 Hexo 博客项目
-
在你电脑中选一个路径用于放置博客(比如 D 盘)
-
打开 PowerShell 或 Git Bash,依次执行:
-
cd D:\ # ← 如果你想放在 D 盘 mkdir my-blog cd my-blog hexo init # my-blog # 创建一个 Hexo 博客项目文件夹 npm install # 安装依赖
✅ 第四步:运行博客,预览首页
-
hexo g # 生成静态页面 hexo s # 启动本地服务器
打开浏览器访问:
👉 http://localhost:4000/
你将看到 Hexo 的默认首页!
-
第五步:安装 Icarus 主题(仿 某个博主的样式)
-
cd themes git clone https://github.com/ppoffice/hexo-theme-icarus.git icarus cd ..
修改博客根目录下的
_config.yml
:把里面这行:
-
theme: landscape
改为:
theme: icarus
然后重新运行:
-
hexo clean hexo g hexo s
再次访问 http://localhost:4000 就会看到熟悉的 Icarus 样式啦!
-
如果出现类似的问题
-
不要慌 大概率是缺少了一些必须项
1. 安装缺失的依赖包
首先,我们需要在 Hexo 项目的根目录下安装缺失的依赖包。
npm install --save bulma-stylus@0.8.0 hexo-component-inferno@^3.1.2 hexo-renderer-inferno@^1.0.2 inferno@^8.2.3 inferno-create-element@^8.2.3
这条命令会根据提示安装所需的依赖。
2. 检查其他依赖包
如果还有其他依赖问题,可以通过以下命令安装所有依赖:
npm install
3. 清理和生成
接下来,执行以下命令清理和生成 Hexo 网站:
hexo clean
hexo g
4. 启动 Hexo
hexo s