2021年gitbook的安裝報錯,一次解決方案!
這里的報錯估計是大多數 人遇到的,亦或者是卡在Installing GitBook 3.2.3的,這種情況我都踩過坑了。
都是因為node.js版本不符合的原因導致,來下面看看問題分析。
nvm list # * 16.7.0 (Currently using 64-bit executable) npm --version # 7.20.3
開始我用這個16.7.0版本解決了報錯,新的BUG隨之而來。
TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer,
TypedArray, or DataView. Received an instance of Promise
下面就跟着步驟解決問題吧。
首先先裝nvm,為什么裝這個?就是node.js各類版本的管理器,隨時能切換版本。
如果遇到這種情況 只需要改下版本就可以解決了,不需要處理依賴或重裝node.js等問題。
# linux系統安裝
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.0/install.sh | bash
# windows 安裝包 https://github.com/coreybutler/nvm-windows/releases/download/1.1.7/nvm-setup.zip
安裝node.js版本
# 這里用的是v12.22.3, 網上說的是v10左右
nvm install v12.22.3
nvm use v12.22.3
# 配置國內加速鏡像
npm config set registry https://registry.npm.taobao.org
npm install -g gitbook-cli
初始化版本
gitbook init #warn: no summary file in this book #info: create SUMMARY.md #info: initialization is finished
發現成功了
把下面內容插入SUMMARY.MD
# Summary * [Introduction](README.md) * [前言](readme.md) * [第一章](part1/README.md) * [第一節](part1/1.md) * [第二節](part1/2.md) * [第三節](part1/3.md) * [第四節](part1/4.md) * [第二章](part2/README.md) * [第三章](part3/README.md) * [第四章](part4/README.md)
打包
gitbook build
可以看到是在D:\nvm\v12.22.3\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js:287
先對這個錯誤進行分析,cb.apply不是函數。 先去看graceful-fs源碼
為了簡單點,還是百度了。
注釋掉62 63 64
gitbook build info: 7 plugins are installed info: 6 explicitly listed info: loading plugin "highlight"... OK info: loading plugin "search"... OK info: loading plugin "lunr"... OK info: loading plugin "sharing"... OK info: loading plugin "fontsettings"... OK info: loading plugin "theme-default"... OK info: found 2 pages info: found 0 asset files info: >> generation finished with success in 0.6s !
成功了
gitbook serve info: 7 plugins are installed info: loading plugin "livereload"... OK info: loading plugin "highlight"... OK info: loading plugin "search"... OK info: loading plugin "lunr"... OK info: loading plugin "sharing"... OK info: loading plugin "fontsettings"... OK info: loading plugin "theme-default"... OK info: found 2 pages info: found 0 asset files info: >> generation finished with success in 0.5s ! Starting server ... Serving book on http://localhost:4000