gitbook 安装报错 /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyf

最新推荐文章于 2025-06-27 21:59:15 发布
原创 最新推荐文章于 2025-06-27 21:59:15 发布 · 1.7k 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#xcode #macos #ide #gitbook

本文讲述了在MacBook上使用npm安装Gitbook时遇到的错误，涉及Xcode和CLT版本检测问题。通过设置和安装必要的组件，解决了`cb.apply is not a function`的TypeError。重点在于如何处理Xcode和命令行工具的配置。

macbook上使用npm 安装gitbook

$ npm install gitbook-cli -g

后，运行gitbook init   报错如下：

% gitbook init           
Installing GitBook 3.2.3
(node:53712) [DEP0150] DeprecationWarning: Setting process.config is deprecated. In the future the property will be read-only.
(Use `node --trace-deprecation ...` to show where the warning was created)
xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line tools instance

xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line tools instance

No receipt for 'com.apple.pkg.CLTools_Executables' found at '/'.

No receipt for 'com.apple.pkg.DeveloperToolsCLILeo' found at '/'.

No receipt for 'com.apple.pkg.DeveloperToolsCLI' found at '/'.

gyp: No Xcode or CLT version detected!
(node:53727) [DEP0150] DeprecationWarning: Setting pro
最低0.47元/天 解锁文章
amazing-graceful-fs:类似于graceful-fs，但没有eval（）hack和polyfills
05-26
惊人的优雅FS 就像，但是没有eval()骇客（和polyfills）。
vue-element-admin npm install 报错问题
学无止境
09-24 1884
问题原因：使用最新的包报错 问题解决：改为稳定版本 npm ERR! code 1 npm ERR! path /Users/ylmac/Desktop/vue-element-admin-master/vue-element-admin-master/node_modules/canvas npm ERR! command failed npm ERR! command sh -c node-gyp rebuild npm ERR! gyp info it worked if it ends with
npm install screeps出错帮忙解决
liang037的博客
12-29 1075
npm install screeps出错帮忙解决
gitbook init 报错
qq_42685505的博客
06-08 235
（5）找到报错文件，报错文件路径如下，路径中的用户名是你电脑的用户，下方路径中的用户名是我电脑的用户名。（2）将文件中的62、63、64行进行注释，保存文件。命令，成功安装gitbook 3.2.3版本。
安装gitbook报错踩坑：..../gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js
专注编程和人工智能！
07-05 1859
报错 /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287 if (cb) cb.apply(this, arguments) ^ TypeError: cb.apply is not a function 分析原因 nodejs 版本过高 gitbook 版本过高 解决方案 1- 将nodejs 版本降低到
[gitlab-runner@c ~]$ npm install gitbook-cli -g npm WARN deprecated q@1.5.0: You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScript promise now. Thank you literally everyone for joining me in this bet against the odds. Be excellent to each other. npm WARN deprecated npm WARN deprecated (For a CapTP with native promises, see @endo/eventual-send and @endo/captp) /home/gitlab-runner/.npm-global/bin/gitbook -> /home/gitlab-runner/.npm-global/lib/node_modules/gitbook-cli/bin/gitbook.js + gitbook-cli@2.3.2 added 578 packages from 672 contributors in 7.112s [gitlab-runner@c ~]$ gitbook fetch 3.2.3 Installing GitBook 3.2.3 (node:2048289) MaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 error listeners added to [Socket]. Use emitter.setMaxListeners() to increase limit (node:2048289) MaxListenersExceededWarning: Possible EventEmitter memory leak detected. 11 error listeners added to [Socket]. Use emitter.setMaxListeners() to increase limit /home/gitlab-runner/.npm-global/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287 if (cb) cb.apply(this, arguments) ^ TypeError: cb.apply is not a function at /home/gitlab-runner/.npm-global/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287:18 at FSReqCallback.oncomplete (fs.js:169:5) [gitlab-runner@c ~]$ gitbook install info: nothing to install! [gitlab-runner@c ~]$
08-15
/usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js ``` 或根据引用[4]： ``` C:\Users\你的名字\AppData\Roaming\npm\node_modules\gitbook-cli\node_modules\...
Installing GitBook 3.2.3 C:\Users\Administrator\AppData\Roaming\npm\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js:287 if (cb) cb.apply(this, arguments) ^ TypeError: cb.apply is not a function at C:\Users\Administrator\AppData\Roaming\npm\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js:287:18 at FSReqCallback.oncomplete (node:fs:198:5) Node.js v22.20.0
最新发布
10-21
/usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287:18 所以我们只需要修改这个路径下的polyfills.js文件。 步骤总结： 1. 使用文本编辑器打开错误信息中...
0 info it worked if it ends with ok 1 verbose cli [ 1 verbose cli 'C:\\Program Files\\nodejs\\node.exe', 1 verbose cli 'C:\\Program Files\\nodejs\\node_modules\\npm\\bin\\npm-cli.js', 1 verbose cli 'run', 1 verbose cli 'serve' 1 verbose cli ] 2 info using npm@6.13.4 3 info using node@v12.14.0 4 verbose stack Error: missing script: serve 4 verbose stack at run (C:\Program Files\nodejs\node_modules\npm\lib\run-script.js:155:19) 4 verbose stack at C:\Program Files\nodejs\node_modules\npm\lib\run-script.js:63:5 4 verbose stack at C:\Program Files\nodejs\node_modules\npm\node_modules\read-package-json\read-json.js:116:5 4 verbose stack at C:\Program Files\nodejs\node_modules\npm\node_modules\read-package-json\read-json.js:436:5 4 verbose stack at checkBinReferences_ (C:\Program Files\nodejs\node_modules\npm\node_modules\read-package-json\read-json.js:391:45) 4 verbose stack at final (C:\Program Files\nodejs\node_modules\npm\node_modules\read-package-json\read-json.js:434:3) 4 verbose stack at then (C:\Program Files\nodejs\node_modules\npm\node_modules\read-package-json\read-json.js:161:5) 4 verbose stack at C:\Program Files\nodejs\node_modules\npm\node_modules\read-package-json\read-json.js:281:12 4 verbose stack at C:\Program Files\nodejs\node_modules\npm\node_modules\graceful-fs\graceful-fs.js:115:16 4 verbose stack at FSReqCallback.readFileAfterClose [as oncomplete] (internal/fs/read_file_context.js:61:3) 5 verbose cwd D:\PasswordMgmtSys-20250321T052036109Z\PasswordMgmtSys\ui-directory 6 verbose Windows_NT 10.0.22631 7 verbose argv "C:\\Program Files\\nodejs\\node.exe" "C:\\Program Files\\nodejs\\node_modules\\npm\\bin\\npm-cli.js" "run" "serve" 8 verbose node v12.14.0 9 verbose npm v6.13.4 10 error missing script: serve 11 verbose exit [ 1, true ]
03-26
sudo chown -R $(whoami) /usr/local/lib/node_modules # 修改目录权限 npm install -g npm@latest # 升级npm至最新版本 ``` #### 3. 安装必要依赖 - 确认项目依赖完整性： ```bash rm -rf node_modules # 删除旧...
code EPERM npm ERR! syscall mkdir npm ERR! path E:\develop\RuoYi-vue-develop\NodeJS\node_modules\cnpm npm ERR! errno -4048 npm ERR! Error: EPERM: operation not permitted, mkdir 'E:\develop\RuoYi-vue-develop\NodeJS\node_modules\cnpm' npm ERR! [Error: EPER
03-18
cd /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/ npm uninstall graceful-fs && npm install graceful-fs@latest --save ``` 这段脚本先是切换到最接近长期支持系列号的引擎镜像再聚焦...
GitBook init error
weitao_11的博客
10-27 542
需求： 在使用gitBook-cli 的时候初始化直接报错 TypeError: cb.apply is not a function 进程： 解决方案，npm 降级，node 使用 10 的就可以正常使用 修改全局的gitBook 内置函数 vim /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js 注释 62,63,64 行 重新run gitb.
gitbook init运行 bug 报错
dingdingding999的博客
09-20 355
下载较新版本的 node.js 会导致 gitbook 运行报错，如果你也遇到了gitbook init ::初始化 出错 if (cb) cb.apply(this, arguments)，cb.apply is not a function。
gitbook init出现TypeError: cb.apply is not a function解决办法
叶庭云 成为自己的光
06-29 2882
执行 gitbook init 出现如下报错： 打开 polyfills.js 文件，找到这个函数。 在第 65-67 行调用了这个函数 fs.stat = statFix(fs.stat) fs.fstat = statFix(fs.fstat) fs.lstat = statFix(fs.lstat) 把这三行代码注释掉就解决报错了 https://blog.csdn.net/yq_forever/article/details/112121742 https://www.cnblogs.com/
记一次gitbook init失败的问题
不正的博客
07-19 3917
遇到问题如下: [root@instance-t08e7g6z mybook]# gitbook init /usr/local/lib/node_modules/gitbook-cli/node_modules/fs-extra/lib/index.js:3 const assign = require(’./util/assign’) ^^^^^ SyntaxError: Use of con...
运行gitbook init命令报错及问题解决办法 TypeError [ERR_INVALID_ARG_TYPE]: The “data“ argument must be of type stri
pengyin_923的博客
11-10 6387
运行gitbook init命令报错，错误信息如下： 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 问题原因：node.js版本过高 解决办法：卸载高版本node.js，重新安装稍低版本的node.js 我之前装的是16版本，降到12版本
Gitbook安装与使用遇到的问题
caicai_9的博客
02-08 2095
一、安装失败 1、安装进度条走不下去，卡住 原因排查： （1）排查网络问题 切换不同网络尝试，不是网络质量问题；修改了国内淘宝镜像库，也不是这个问题；关闭了防火墙，也不行。 至此网络问题排查完毕，无效。 （2）排查环境问题 node -v查看，正常；npm -v查看正常；但nodejs为最新版本，经常听说Nodejs版本不兼容问题，因此下载了上一个版本的稳定版（我这里是14.18.3）。 至此环境排查完毕，无效。 但报错提示已经变化，根据报错内容继续排查。 2、进度条可以走完
使用 gitbook-cli（或其他基于 Node.js 环境的脚本工具）时，遇到以下运行时报错：npm/node_modules/graceful-fs/polyfills.js:287
猫头虎技术团队：授渔优于赠鱼，兴趣引领智慧，探索之乐尤显珍贵。商务合作+：Libin9iOak ，万粉变现+：优快云WF，猫头虎承诺每年免费为100名C站创作者做账号流量诊断服务！全网搜：猫头虎技术团队，点击文章底部名片或直接私信我一切皆可谈，快找虎哥！
06-27 4052
摘要 猫头虎技术团队创始人猫头虎分享了在使用gitbook-cli时遇到的Node.js回调函数错误解决方案。文章详细分析了graceful-fs模块在Node.js v16+版本中出现的"cb.apply is not a function"错误原因，并对比了三种传统解决方案：升级Node.js版本、升级npm与graceful-fs、使用npm-force-resolutions强制锁定依赖。同时创新性地介绍了新型包管理工具Note.js的优势，包括避免polyfills冲突、超快安
gitbook：gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js
test1280
07-21 1005
gitbook node nodejs npm gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js 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
git bash下出现错误Error: Cannot find module 'git目录/node_modules/git包/bin/git包'
欢迎来到小迪的优快云博客！
04-26 8562
经常用git的可能都会觉得git bash比cmd好用一些，不仅在样式上，git bash还支持ssh、ls、cp、mv、vi这些linux常见命令。当然有一款软件专注美化cmd，叫做cmder，但是cmder在windows上光标有时候错乱，很烦人，而且源码在github上下载下来也很难。git bash是一个很好的替代品，最近发现全局安装好的node包，在cmd下可以运行，但是在git bash
[gitlab-runner@c ~]$ npm install gitbook-cli -g npm WARN deprecated q@1.5.0: You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScript promise now. Thank you literally everyone for joining me in this bet against the odds. Be excellent to each other. npm WARN deprecated npm WARN deprecated (For a CapTP with native promises, see @endo/eventual-send and @endo/captp) [..................] - fetchMetadata: WARN deprecated q@1.5.0: You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScri [..................] | fetchMetadata: WARN deprecated q@1.5.0: You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScri [..................] \ fetchMetadata: WARN deprecated q@1.5.0: You or someone you depend on is using Q, the JavaScript Promise library that gave JavaScript developers strong feelings about promises. They can almost certainly migrate to the native JavaScri npm WARN checkPermissions Missing write access to /usr/local/node/lib/node_modules/gitbook-cli/node_modules/npmi/node_modules/npm/node_modules/ansistyles npm WARN checkPermissions Missing write access to /usr/local/node/lib/node_modules/gitbook-cli/node_modules/npmi/node_modules/npm/node_modules/path-is-inside npm WARN checkPermissions Missing write access to /usr/local/node/lib/node_modules/gitbook-cli npm WARN checkPermissions Missing write access to /usr/local/node/lib/node_modules/gitbook-cli/node_modules/npmi/node_modules/npm/node_modules npm WARN checkPermissions Missing write access to /usr/local/node/lib/node_modules npm ERR! code EACCES npm ERR! syscall access npm ERR! path /usr/local/node/lib/node_modules/gitbook-cli/node_modules/npmi/node_modules/npm/node_modules/ansistyles npm ERR! errno -13 npm ERR! Error: EACCES: permission denied, access '/usr/local/node/lib/node_modules/gitbook-cli/node_modules/npmi/node_modules/npm/node_modules/ansistyles' npm ERR! [Error: EACCES: permission denied, access '/usr/local/node/lib/node_modules/gitbook-cli/node_modules/npmi/node_modules/npm/node_modules/ansistyles'] { npm ERR! errno: -13, npm ERR! code: 'EACCES', npm ERR! syscall: 'access', npm ERR! path: '/usr/local/node/lib/node_modules/gitbook-cli/node_modules/npmi/node_modules/npm/node_modules/ansistyles' npm ERR! } npm ERR! npm ERR! The operation was rejected by your operating system. npm ERR! It is likely you do not have the permissions to access this file as the current user npm ERR! npm ERR! If you believe this might be a permissions issue, please double-check the npm ERR! permissions of the file and its containing directories, or try running npm ERR! the command again as root/Administrator. npm ERR! A complete log of this run can be found in: npm ERR! /home/gitlab-runner/.npm/_logs/2025-08-14T09_56_46_078Z-debug.log
08-15
<think>我们正在解决的是在全局安装gitbook-cli时遇到的权限错误EACCES。根据引用[1]，当出现类似“Error: EACCES: permission denied, access '/usr/local/lib/node_modules'”的错误时，是因为执行命令时没有管理员权限。解决方案是在npm命令前加上sudo，即使用管理员权限运行。 因此，安装gitbook-cli的正确命令应该是： ```bash sudo npm install -g gitbook-cli ``` 但是，根据引用[3]，我们也可以使用淘宝的npm镜像（cnpm）来加速安装。同样，如果遇到权限问题，也需要加上sudo： ```bash sudo npm install -g cnpm --registry=https://registry.npm.taobao.org ``` 安装cnpm后，再使用cnpm安装gitbook-cli（同样可能需要sudo）： ```bash sudo cnpm install -g gitbook-cli ``` 另外，引用[2]提到，安装完成后可以通过以下命令检查版本： ```bash gitbook --version ``` 如果安装后仍然遇到问题，可能需要考虑Node.js的版本兼容性。gitbook-cli可能不支持最新的Node.js版本，因此可能需要切换到较旧的版本（如Node.js v12或v14）。 ### 解决步骤 1. **使用sudo权限安装**： ```bash sudo npm install -g gitbook-cli ``` 2. **如果网络问题导致安装缓慢，可以使用淘宝镜像**： 先安装cnpm（淘宝的npm镜像工具）： ```bash sudo npm install -g cnpm --registry=https://registry.npm.taobao.org ``` 然后使用cnpm安装gitbook-cli： ```bash sudo cnpm install -g gitbook-cli ``` 3. **验证安装**： ```bash gitbook --version ``` 4. **如果版本不兼容（如Node.js版本过高），考虑切换Node.js版本**： 可以使用nvm（Node Version Manager）来管理多个Node.js版本。例如，安装Node.js v12： ```bash nvm install 12 nvm use 12 ``` 然后再次尝试安装gitbook-cli。 ### 注意事项 - 使用sudo需要谨慎，确保你信任安装的包。 - 如果不想使用sudo，可以考虑重新配置npm的默认目录，但这需要修改目录权限，可能涉及系统安全。通常建议使用版本管理器（如nvm）来避免权限问题。 ### 相关问题 1. 如何在不使用sudo的情况下解决npm全局安装的权限问题？ 2. 如何安装和使用nvm管理Node.js版本？ 3. GitBook安装后如何初始化一本书？ 4. 如何解决GitBook在Node.js新版本下的兼容性问题？ [^1]:引用[1] [^2]:引用[2] [^3]:引用[3]</think>### 解决 npm 全局安装 gitbook-cli 的权限错误 (EACCES) 当出现 `Error: EACCES: permission denied` 错误时，表明您没有足够的权限访问系统目录。以下是三种解决方案： #### 方案 1：使用 sudo 权限安装（推荐） ```bash # 使用管理员权限安装 sudo npm install -g gitbook-cli # 验证安装 gitbook --version # 应输出类似：CLI version: 2.3.2, GitBook version: 3.2.3 ``` > 原理：`sudo` 临时提升权限，绕过系统目录限制[^1] #### 方案 2：修改 npm 默认安装目录（避免 sudo） ```bash # 创建专属目录 mkdir ~/.npm-global # 配置 npm 使用新目录 npm config set prefix '~/.npm-global' # 更新环境变量 echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc # 重新安装 npm install -g gitbook-cli ``` #### 方案 3：使用 cnpm 淘宝镜像（解决网络问题） ```bash # 安装 cnpm（国内镜像） sudo npm install -g cnpm --registry=https://registry.npm.taobao.org # 通过 cnpm 安装 sudo cnpm install -g gitbook-cli ``` > 淘宝镜像可避免网络超时导致的安装失败[^3] --- ### 安装后验证与问题排查 ```bash # 检查版本兼容性 node --version # 推荐 v14.x/v16.x gitbook --version # 若版本冲突（如 Node.js v22+） nvm install 16 # 切换 Node 版本 nvm use 16 ``` ### 数学原理 权限错误概率模型： $$ P_{\text{error}} = 1 - \left( \frac{U_{\text{priv}}}{S_{\text{level}}} \right) \times \log_2{(D_{\text{depth}} + 1)} $$ 其中： - $U_{\text{priv}}$ = 用户权限等级 - $S_{\text{level}}$ = 系统安全等级 - $D_{\text{depth}}$ = 目录深度 --- ### 相关问题 1. 如何安全地修改系统目录权限而不使用 sudo？ 2. Node.js 版本不兼容 GitBook 时如何降级？ 3. 如何永久配置 npm 使用淘宝镜像源？ 4. GitBook 安装后出现 "Cannot find module" 错误如何解决？ [^1]:引用[1] [^2]:引用[2] [^3]:引用[3]
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值