Gitbook安装与使用遇到的问题

一、安装失败

1、安装进度条走不下去，卡住

原因排查：

（1）排查网络问题

切换不同网络尝试，不是网络质量问题；修改了国内淘宝镜像库，也不是这个问题；关闭了防火墙，也不行。

至此网络问题排查完毕，无效。

（2）排查环境问题

node -v查看，正常；npm -v查看正常；但nodejs为最新版本，经常听说Nodejs版本不兼容问题，因此下载了上一个版本的稳定版（我这里是14.18.3）。

至此环境排查完毕，无效。

但报错提示已经变化，根据报错内容继续排查。

2、进度条可以走完，出现报错4048

 考虑清缓存，同时查看报错内容，包含很多未知的nodejs文件路径，我的node是默认路径C:\ProgramFiles路径，因此，将提示路径的nodejs文件删除，但仍然不行；

将当前安装的node卸载，重启，重新安装，再进行安装，终于安装完成！

二、安装成功后无法初始化及构建电子书

在PyCharm控制台，对一个电子书项目进行构建。

gitbook build报错：tunneling socket could not be established, statusCode=400

通过查询node日志获取详细错误内容：根据日志，查询到是代理问题。 

查看当前代理：npm config get proxy

如果代理设置是null，需要配置新的代理地址：npm config set registry https://registry.cnpmjs.org/（根据情况，设置是指定地址还是默认的国内cnpm淘宝镜像）。

设置完成后，仍然无效。

尝试更换npm版本，例如：npm install npm@6.14.10 -g

安装所需依赖包更新完成。

（这时我以为已经安装完成，但gitbook -V验证的时候有光标转动显示正在安装，且最终安装失败。）

这时根据gitbook -V安装失败的报错继续查找，报错：cb.apply is not a function...

最终解决办法是：按错误提示的路径找到polyfills.js文件，根据显示的行数，找到相关语句，进行修改（这里我就不知道原因了，网上查技术贴说是旧版本的某方面问题），还说在这个文件中，找到了三行含有“statFix(fs.stat)”的语句，将其注释。

同时原帖奉上，建议大家学习看看：Gitbook错误"cb.apply is not a function"的解决办法 - 简书

至此，gitbook安装成功，gitbook -V验证。

至此gitbook安装完成。

备注：本机尝试安装了5个不同版本的Nodejs，兼容性问题比较多，最后我创建了一台Windows虚拟机，版本较低，环境干净，单独装了个Nodejs，直接安装gitbook，一次成功，可正常使用。。。我也很无奈。。。本机安装与使用一直遇到问题，但还没有明白是什么原因，感觉是兼容性，及Node有些版本可能本身就存在bug。算了，就不就结了。