返回

GitBook 运行时报错？降低 node 版本轻松搞定！

前端

在公司使用公用组件时，总是苦于文档不健全，每次调用时都要查看代码，效率低下。为了方便自己和他人使用，我决定为自己的组件编写开发文档。在一番探索后，我选择了 GitBook 作为文档编写工具。

刚开始使用 GitBook 时，一切都很顺利。然而，当我按照文档指示安装完 GitBook CLI 后，在运行时却遇到了一个令人头疼的错误。经过一番折腾，我发现可以通过降低 Node.js 版本来解决这个问题。

GitBook 运行时报错：Node.js 版本过高

$ gitbook serve
internal/modules/cjs-loader.js:1069
  throw err;
  ^

Error: Cannot find module '/home/user/.gitbook/node_modules/pug-loader/lib/index.js'
    at Function.Module._resolveFilename (internal/modules/cjs-loader.js:1064:15)
    at Function.Module._load (internal/modules/cjs-loader.js:937:27)
    at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:71:12)
    at internal/main/run_main_module.js:17:47

解决方法：降低 Node.js 版本

根据错误信息，我猜测问题可能出在 Node.js 版本上。于是，我查看了 GitBook 官方文档，发现其推荐的 Node.js 版本为 14.15.1。而我当时使用的版本是 16.13.2。

为了解决这个问题，我将 Node.js 版本降低至 14.15.1。具体操作步骤如下：

  1. 使用 nvm 安装 Node.js 14.15.1 版本：
nvm install 14.15.1
  1. 将 nvm 设为默认版本管理器：
nvm alias default 14.15.1
  1. 重新运行 GitBook CLI：
gitbook serve

总结

通过降低 Node.js 版本，我成功解决了 GitBook 运行时报错的问题。这个经验也让我意识到，在使用第三方工具时，一定要仔细阅读官方文档，了解其推荐的环境配置。

希望我的这篇博文能够帮助其他遇到类似问题的 GitBook 用户。如果您有任何问题或建议，欢迎在评论区留言。