优雅配置系列：Node.js、NVM 与 Hexo 博客搭建

Zero. 写在前面的话

搞前端或者想自己搭博客（比如现在这套 Hexo）的朋友，这辈子注定是逃不开 Node.js 的。

---

One. NVM

很多教程会让你直接去 Node.js 官网下载 .exe 安装包。不建议。

由于很多老的博客主题（或者老项目）对 Node 的版本有严格要求，如果你只装一个版本，以后遇到版本冲突会极其痛苦（没错，我痛苦过）。所以，我们需要先配好 NVM (Node Version Manager)。

顾名思义，它就是一个用来管理 Node.js 版本的工具。它让你可以随时在不同版本的 Node 之间切换（不过有些东西可能要重复装，除非用全局，但是搞全局一般不好）。

1. 安装 NVM

去 GitHub 搜索 nvm-windows 下载 nvm-setup.exe。安装时建议：

• NVM 的安装路径设为：D:\Environment\nvm
• Node.js 的快捷方式路径设为：D:\Environment\NodeJS

2. NVM 常用命令

打开终端（比如 PowerShell 或 Cmder），敲下面这几行命令就能搞定 Node 安装：

# 查看所有能安装的 Node 版本
nvm list available

# 安装最新的长期支持版（比如 20.x 或 22.x）
nvm install lts

# 查看你当前装了哪些版本
nvm list

# 切换使用某个版本
nvm use <版本号>

提醒：在 Windows 下执行 nvm use 如果报错，通常是因为权限不够，记得用管理员身份运行终端再试一次。

---

Two. NPM 与环境搬家

Node.js 装好后，自带了一个买一送一的玩意：NPM (Node Package Manager)。
它的作用是帮你下载全球开发者写好的现成代码包（比如后面我们要用的 Hexo 本体）。

1. 为什么要搬家？

npm install -g xxx（全局安装某个包）时，它默认会把上百兆的文件全部 C 盘：C:\Users\<你的用户名>\AppData\Roaming\npm。

so，必须给它做环境移植

2. 移植操作

首先，在你的 Node 目录（D:\Environment\NodeJS）下手动新建两个空文件夹：

• node_global （全局包存放地）
• node_cache （缓存存放地）

然后，在终端里强制修改 NPM 的默认路径：

npm config set prefix "D:\Environment\NodeJS\node_global"
npm config set cache "D:\Environment\NodeJS\node_cache"

提速：由于 NPM 的服务器在国外，下载极慢。建议顺手把下载源换成国内淘宝镜像：
npm config set registry https://registry.npmmirror.com

不过如果你习惯性开魔法，也配置好了wsl和win的网络共享，那倒也无所谓。

3. 最关键的一步：配置环境变量

由于你把全局包换到了 node_global，系统找不到你下载的命令了。

右键“此电脑” -> 属性 -> 高级系统设置 -> 环境变量：

1. 找到 系统变量 里的 Path，添加一行：D:\Environment\NodeJS\node_global
2. 找到 用户变量 里的 Path，把原来那个指向 C:\Users\...\npm 的路径删掉，也换成 D:\Environment\NodeJS\node_global。

---

Three. Hexo：搭建博客

1. 全局安装 Hexo

在终端输入：

npm install -g hexo-cli

参数 -g 的意思就是 global 全局安装

2. 初始化博客

来到你的代码工作区，比如 D:\Workspace：

# 生成一个名叫 MyBlog 的博客文件夹
hexo init MyBlog

# 进入文件夹
cd MyBlog

# 安装博客需要的基础依赖包
npm install

3. 本地预览

一切就绪后，在你的博客文件夹下输入启动命令：

hexo server
# 或者简写为：hexo s

终端会提示你：Hexo is running at http://localhost:4000/。
打开你的浏览器，输入这个网址，恭喜你，你的个人博客已经诞生了~

---

👉 点击这里继续阅读：《优雅配置系列番外：JS、Node 与全栈》