$ hexo clean ERROR Cannot find module 'hexo' from 'D:\Blog' ERROR Local hexo loading failed in D:\Blog ERROR Try running: 'rm -rf node_modules && npm install --force'

这个错误提示是因为 Hexo 模块没有正确安装或者安装出现问题导致的。你可以尝试以下步骤来解决这个问题：

1. 确认你已经安装了 Node.js 环境；
2. 进入你的博客根目录，在终端中执行 `rm -rf node_modules` 命令，删除已有的 node_modules 文件夹；
3. 然后执行 `npm install --force` 命令，重新安装 Hexo 及其依赖包；
4. 最后执行 `hexo clean` 命令，清理 Hexo 生成的文件。

如果还是无法解决问题，可以尝试升级 Node.js 版本或者重新安装 Hexo。

相关问题

C:\Users\胡明珠\blog>hexo -v ERROR Cannot find module 'hexo' from 'C:\Users\胡明珠\blog' ERROR Local hexo loading failed in ~\blog ERROR Try running: 'rm -rf node_modules && npm install --force'

这个错误提示表明在你的本地 hexo 环境加载失败。你可以尝试运行命令 `rm -rf node_modules && npm install --force`，该命令将会删除你的 `node_modules` 目录，并重新安装所有依赖。如果问题依旧存在，你可以尝试使用管理员权限运行命令行窗口，或者检查你的环境变量是否正确设置。

hexo s ERROR Cannot find module 'hexo'

### 解决 Hexo 启动时找不到模块的问题

当遇到 `ERROR Plugin load failed` 或者 `Cannot find module '...'` 类型的错误时，通常是因为某些必要的依赖包未安装或路径配置不正确。对于具体提到的 `cannot find module 'hexo'` 错误，可以按照以下方法排查并解决问题。

#### 1. 清理缓存和重新安装依赖
有时全局缓存可能会导致问题，建议先清理 npm 缓存再尝试重新安装所有依赖项：

npm cache clean --force
rm -rf node_modules package-lock.json
npm install

这一步骤有助于清除可能损坏的本地缓存文件，并确保所有的依赖都被最新版本所替换[^1]。

#### 2. 验证 Node.js 和 NPM 版本兼容性
确认当前使用的 Node.js 及其配套工具链 (NPM/Yarn) 是否与 Hexo 所需环境相匹配。可以通过命令行查看已安装版本号:

node -v
npm -v

如果发现版本过低，则应考虑升级至官方推荐的支持范围内的版本[^4]。

#### 3. 明确指定 Hexo CLI 安装方式
为了避免潜在冲突，在项目根目录下通过如下指令来局部安装 Hexo CLI 工具而不是全局安装：

npm install hexo-cli --save-dev
npx hexo init .
npx hexo server

使用 npx 命令可以直接调用本地 node_modules/.bin 下面的可执行程序而无需额外设置 PATH 环境变量。

#### 4. 插件及主题相关问题处理
针对特定插件加载失败的情况，比如 `hexo-wordcount` 报错无法找到 `'hexo-util'` ，应该单独为该项目安装缺失的基础库：

npm install hexo-util --save

同样地，对于自定义主题内脚本报错的情形（如 renderer.js），也需要检查该主题所需的特殊依赖是否存在并正常工作。必要时参照文档说明手动添加缺少的部分[^2]。

#### 5. 检查全局 vs 局部安装差异
注意区分全局 (`-g`) 参数下的安装行为同仅限于当前项目的局部安装之间的区别。前者会影响整个系统的其他应用程序；后者则只作用于单个项目实例。因此除非确实需要跨多个站点共享同一个 Hexo 实例，否则一般推荐采用局部模式管理各个博客工程独立运行所需资源。